> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orgo.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Get template
> Fetch a single template version and its full document.
Returns one template version, including the complete `orgo.ai/v1` document. Curated templates resolve here too — use their `system` namespace, e.g. `system/claude-code/1.0.0`.
## Path parameters
Template namespace. Your own templates default to `default`.
Template name.
Version (semver), e.g. `1.0.0`.
## Response
Template ref, `namespace/name@version`.
Content-addressed SHA-256 digest.
ISO 8601 publish timestamp.
The full template document. See the [schema reference](/guides/templates/schema).
## Example
```bash cURL theme={null}
curl https://www.orgo.ai/api/templates/default/claude-code/1.0.0 \
-H "Authorization: Bearer $ORGO_API_KEY"
```
```python Python theme={null}
import os, requests
r = requests.get(
"https://www.orgo.ai/api/templates/default/claude-code/1.0.0",
headers={"Authorization": f"Bearer {os.environ['ORGO_API_KEY']}"},
)
print(r.json()["template"])
```
```javascript JavaScript theme={null}
const r = await fetch(
"https://www.orgo.ai/api/templates/default/claude-code/1.0.0",
{ headers: { Authorization: `Bearer ${process.env.ORGO_API_KEY}` } },
);
const item = await r.json();
console.log(item.template);
```
### Response
```json theme={null}
{
"ref": "default/claude-code@1.0.0",
"digest": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2",
"published": "2026-06-08T17:00:00Z",
"template": {
"api_version": "orgo.ai/v1",
"template": {
"name": "claude-code",
"version": "1.0.0",
"description": "Claude Code CLI, ready in the terminal."
},
"hardware": { "cpu": 2, "ram_gb": 4, "resolution": "1280x720x24" }
}
}
```
## Errors
| Status | Meaning |
| ------ | ------------------------------------------- |
| `401` | Missing or invalid API key. |
| `404` | No such template version in this namespace. |
## OpenAPI
````yaml GET /templates/{namespace}/{name}/{version}
openapi: 3.1.0
info:
title: Orgo API
description: >-
Launch cloud computers that AI agents can control and interact with. Create
workspaces, provision computers, and control them programmatically.
version: 2.0.0
contact:
name: Orgo Support
email: spencer@orgo.ai
url: https://orgo.ai
servers:
- url: https://www.orgo.ai/api
description: Production
security:
- bearerAuth: []
tags:
- name: Workspaces
description: Organize computers into named workspaces
- name: Computers
description: Provision and manage virtual computers
- name: Computer Lifecycle
description: Start, stop, and restart computers
- name: Computer Actions
description: Control mouse, keyboard, and execute commands
- name: Streaming
description: Stream computer display via RTMP
- name: Files
description: Upload and download files
- name: Templates
description: Author, build, and launch reproducible computers from templates
paths:
/templates/{namespace}/{name}/{version}:
get:
tags:
- Templates
summary: Get template
description: >-
Fetches one template version, including the full document. Use the
`system` namespace for curated templates, e.g.
`system/claude-code/1.0.0`.
operationId: getTemplate
parameters:
- name: namespace
in: path
required: true
schema:
type: string
- name: name
in: path
required: true
schema:
type: string
- name: version
in: path
required: true
schema:
type: string
responses:
'200':
description: Template version
content:
application/json:
schema:
$ref: '#/components/schemas/TemplateListItem'
'401':
$ref: '#/components/responses/Unauthorized'
'404':
$ref: '#/components/responses/NotFound'
components:
schemas:
TemplateListItem:
type: object
properties:
ref:
type: string
description: Template ref, `namespace/name@version`.
example: default/claude-code@1.0.0
digest:
type: string
description: >-
Content-addressed SHA-256 digest of the canonical template. Two
semantically identical templates always share a digest.
published:
type: string
format: date-time
template:
$ref: '#/components/schemas/Template'
Template:
type: object
description: >-
An orgo.ai/v1 template document. Only `api_version` and `template` are
required. See the full JSON Schema at GET /template-schema, or the
schema guide at https://docs.orgo.ai/guides/templates/schema.
required:
- api_version
- template
additionalProperties: true
properties:
api_version:
type: string
enum:
- orgo.ai/v1
template:
type: object
required:
- name
- version
properties:
name:
type: string
description: Lowercase kebab-case, 1-64 chars.
example: claude-code
version:
type: string
description: Semver, immutable once published.
example: 1.0.0
description:
type: string
hardware:
type: object
secrets:
type: array
items:
type: object
vars:
type: object
env:
type: object
build:
type: object
files:
type: array
apps:
type: array
triggers:
type: array
terminal:
type: array
hooks:
type: object
telemetry:
type: object
egress_policy:
type: object
streaming:
type: array
Error:
type: object
properties:
error:
type: string
description: Error message
responses:
Unauthorized:
description: Invalid or missing API key
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error: Invalid API key
NotFound:
description: Resource not found
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error: Resource not found
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: API key authentication. Get your key at orgo.ai/workspaces
````