curl "https://app.runtm.com/api/agent-directives/dir_abc123?include_content=true" \
-H "Authorization: Bearer runtm_xxx" \
-H "X-Organization-Id: org_abc123"
import requests
response = requests.get(
"https://app.runtm.com/api/agent-directives/dir_abc123",
headers={
"Authorization": "Bearer runtm_xxx",
"X-Organization-Id": "org_abc123",
},
params={"include_content": True},
)
data = response.json()
directive = data["directive"]
print(f"{directive['name']} v{directive['version']}")
const response = await fetch(
"https://app.runtm.com/api/agent-directives/dir_abc123?include_content=true",
{
headers: {
"Authorization": "Bearer runtm_xxx",
"X-Organization-Id": "org_abc123",
},
}
);
const data = await response.json();
console.log(`${data.directive.name} v${data.directive.version}`);
{
"directive": {
"id": "dir_abc123",
"type": "skill_v0",
"name": "deploy-to-fly",
"display_name": "Deploy to Fly.io",
"description": "Guides the agent through Fly.io deployments",
"organization_id": "org_abc123",
"owner_user_id": "user_xyz",
"content_kind": "inline",
"content_hash": "sha256:abcdef...",
"size_bytes": 4096,
"source": {
"kind": "github_repo",
"uri": "owner/repo",
"ref": "main",
"commit_sha": "a1b2c3d",
"path": ".claude/skills/deploy-to-fly/SKILL.md"
},
"attachments": {
"repos": ["owner/repo"],
"applies_to_all": false
},
"content": {
"entry_md": "SKILL.md",
"files": [
{
"path": "SKILL.md",
"inline": "# Deploy to Fly.io\n\nStep-by-step deployment guide..."
}
]
},
"created_at": "2026-04-15T10:00:00Z",
"updated_at": "2026-05-01T12:00:00Z"
}
}
{
"detail": "Directive not found"
}
Skills
Get Skill
Retrieve a single agent directive by ID
GET
/
api
/
agent-directives
/
{directive_id}
curl "https://app.runtm.com/api/agent-directives/dir_abc123?include_content=true" \
-H "Authorization: Bearer runtm_xxx" \
-H "X-Organization-Id: org_abc123"
import requests
response = requests.get(
"https://app.runtm.com/api/agent-directives/dir_abc123",
headers={
"Authorization": "Bearer runtm_xxx",
"X-Organization-Id": "org_abc123",
},
params={"include_content": True},
)
data = response.json()
directive = data["directive"]
print(f"{directive['name']} v{directive['version']}")
const response = await fetch(
"https://app.runtm.com/api/agent-directives/dir_abc123?include_content=true",
{
headers: {
"Authorization": "Bearer runtm_xxx",
"X-Organization-Id": "org_abc123",
},
}
);
const data = await response.json();
console.log(`${data.directive.name} v${data.directive.version}`);
{
"directive": {
"id": "dir_abc123",
"type": "skill_v0",
"name": "deploy-to-fly",
"display_name": "Deploy to Fly.io",
"description": "Guides the agent through Fly.io deployments",
"organization_id": "org_abc123",
"owner_user_id": "user_xyz",
"content_kind": "inline",
"content_hash": "sha256:abcdef...",
"size_bytes": 4096,
"source": {
"kind": "github_repo",
"uri": "owner/repo",
"ref": "main",
"commit_sha": "a1b2c3d",
"path": ".claude/skills/deploy-to-fly/SKILL.md"
},
"attachments": {
"repos": ["owner/repo"],
"applies_to_all": false
},
"content": {
"entry_md": "SKILL.md",
"files": [
{
"path": "SKILL.md",
"inline": "# Deploy to Fly.io\n\nStep-by-step deployment guide..."
}
]
},
"created_at": "2026-04-15T10:00:00Z",
"updated_at": "2026-05-01T12:00:00Z"
}
}
{
"detail": "Directive not found"
}
Returns the full details of a single agent directive, optionally including its content.
Required scope:
context:read
Path Parameters
string
required
The directive ID (e.g.
dir_abc123).Query Parameters
boolean
default:"false"
When
true, includes the full content payload in the response.Headers
string
required
Bearer token. Example:
Bearer runtm_xxxstring
Scope to an organization.
Response
object
The directive resource with metadata, source provenance, and attachment summary.
curl "https://app.runtm.com/api/agent-directives/dir_abc123?include_content=true" \
-H "Authorization: Bearer runtm_xxx" \
-H "X-Organization-Id: org_abc123"
import requests
response = requests.get(
"https://app.runtm.com/api/agent-directives/dir_abc123",
headers={
"Authorization": "Bearer runtm_xxx",
"X-Organization-Id": "org_abc123",
},
params={"include_content": True},
)
data = response.json()
directive = data["directive"]
print(f"{directive['name']} v{directive['version']}")
const response = await fetch(
"https://app.runtm.com/api/agent-directives/dir_abc123?include_content=true",
{
headers: {
"Authorization": "Bearer runtm_xxx",
"X-Organization-Id": "org_abc123",
},
}
);
const data = await response.json();
console.log(`${data.directive.name} v${data.directive.version}`);
{
"directive": {
"id": "dir_abc123",
"type": "skill_v0",
"name": "deploy-to-fly",
"display_name": "Deploy to Fly.io",
"description": "Guides the agent through Fly.io deployments",
"organization_id": "org_abc123",
"owner_user_id": "user_xyz",
"content_kind": "inline",
"content_hash": "sha256:abcdef...",
"size_bytes": 4096,
"source": {
"kind": "github_repo",
"uri": "owner/repo",
"ref": "main",
"commit_sha": "a1b2c3d",
"path": ".claude/skills/deploy-to-fly/SKILL.md"
},
"attachments": {
"repos": ["owner/repo"],
"applies_to_all": false
},
"content": {
"entry_md": "SKILL.md",
"files": [
{
"path": "SKILL.md",
"inline": "# Deploy to Fly.io\n\nStep-by-step deployment guide..."
}
]
},
"created_at": "2026-04-15T10:00:00Z",
"updated_at": "2026-05-01T12:00:00Z"
}
}
{
"detail": "Directive not found"
}