curl -X PATCH "https://app.runtm.com/api/agent-directives/dir_abc123" \
-H "Authorization: Bearer runtm_xxx" \
-H "X-Organization-Id: org_abc123" \
-H "Content-Type: application/json" \
-d '{
"display_name": "Deploy to Fly.io (v2)",
"description": "Updated deployment guide with GPU support"
}'
import requests
response = requests.patch(
"https://app.runtm.com/api/agent-directives/dir_abc123",
headers={
"Authorization": "Bearer runtm_xxx",
"X-Organization-Id": "org_abc123",
"Content-Type": "application/json",
},
json={
"display_name": "Deploy to Fly.io (v2)",
"description": "Updated deployment guide with GPU support",
},
)
data = response.json()
print(f"Updated: {data['directive']['display_name']}")
const response = await fetch(
"https://app.runtm.com/api/agent-directives/dir_abc123",
{
method: "PATCH",
headers: {
"Authorization": "Bearer runtm_xxx",
"X-Organization-Id": "org_abc123",
"Content-Type": "application/json",
},
body: JSON.stringify({
display_name: "Deploy to Fly.io (v2)",
description: "Updated deployment guide with GPU support",
}),
}
);
const data = await response.json();
console.log(`Updated: ${data.directive.display_name}`);
{
"directive": {
"id": "dir_abc123",
"type": "skill_v0",
"name": "deploy-to-fly",
"display_name": "Deploy to Fly.io (v2)",
"description": "Updated deployment guide with GPU support",
"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"
},
"attachments": {
"repos": ["owner/repo"],
"applies_to_all": false
},
"created_at": "2026-04-15T10:00:00Z",
"updated_at": "2026-05-09T21:00:00Z"
}
}
Skills
Update Skill
Partially update a directive’s metadata or content
PATCH
/
api
/
agent-directives
/
{directive_id}
curl -X PATCH "https://app.runtm.com/api/agent-directives/dir_abc123" \
-H "Authorization: Bearer runtm_xxx" \
-H "X-Organization-Id: org_abc123" \
-H "Content-Type: application/json" \
-d '{
"display_name": "Deploy to Fly.io (v2)",
"description": "Updated deployment guide with GPU support"
}'
import requests
response = requests.patch(
"https://app.runtm.com/api/agent-directives/dir_abc123",
headers={
"Authorization": "Bearer runtm_xxx",
"X-Organization-Id": "org_abc123",
"Content-Type": "application/json",
},
json={
"display_name": "Deploy to Fly.io (v2)",
"description": "Updated deployment guide with GPU support",
},
)
data = response.json()
print(f"Updated: {data['directive']['display_name']}")
const response = await fetch(
"https://app.runtm.com/api/agent-directives/dir_abc123",
{
method: "PATCH",
headers: {
"Authorization": "Bearer runtm_xxx",
"X-Organization-Id": "org_abc123",
"Content-Type": "application/json",
},
body: JSON.stringify({
display_name: "Deploy to Fly.io (v2)",
description: "Updated deployment guide with GPU support",
}),
}
);
const data = await response.json();
console.log(`Updated: ${data.directive.display_name}`);
{
"directive": {
"id": "dir_abc123",
"type": "skill_v0",
"name": "deploy-to-fly",
"display_name": "Deploy to Fly.io (v2)",
"description": "Updated deployment guide with GPU support",
"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"
},
"attachments": {
"repos": ["owner/repo"],
"applies_to_all": false
},
"created_at": "2026-04-15T10:00:00Z",
"updated_at": "2026-05-09T21:00:00Z"
}
}
Updates one or more fields on a directive. Only provided fields are changed; omitted fields remain untouched.
Required scope:
context:write
Path Parameters
string
required
The directive ID (e.g.
dir_abc123).Headers
string
required
Bearer token. Example:
Bearer runtm_xxxstring
Scope to an organization.
Body
string
Updated human-readable name.
string
Updated description.
object
Updated content payload matching the directive’s type.
Response
object
The updated directive resource with full content included.
curl -X PATCH "https://app.runtm.com/api/agent-directives/dir_abc123" \
-H "Authorization: Bearer runtm_xxx" \
-H "X-Organization-Id: org_abc123" \
-H "Content-Type: application/json" \
-d '{
"display_name": "Deploy to Fly.io (v2)",
"description": "Updated deployment guide with GPU support"
}'
import requests
response = requests.patch(
"https://app.runtm.com/api/agent-directives/dir_abc123",
headers={
"Authorization": "Bearer runtm_xxx",
"X-Organization-Id": "org_abc123",
"Content-Type": "application/json",
},
json={
"display_name": "Deploy to Fly.io (v2)",
"description": "Updated deployment guide with GPU support",
},
)
data = response.json()
print(f"Updated: {data['directive']['display_name']}")
const response = await fetch(
"https://app.runtm.com/api/agent-directives/dir_abc123",
{
method: "PATCH",
headers: {
"Authorization": "Bearer runtm_xxx",
"X-Organization-Id": "org_abc123",
"Content-Type": "application/json",
},
body: JSON.stringify({
display_name: "Deploy to Fly.io (v2)",
description: "Updated deployment guide with GPU support",
}),
}
);
const data = await response.json();
console.log(`Updated: ${data.directive.display_name}`);
{
"directive": {
"id": "dir_abc123",
"type": "skill_v0",
"name": "deploy-to-fly",
"display_name": "Deploy to Fly.io (v2)",
"description": "Updated deployment guide with GPU support",
"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"
},
"attachments": {
"repos": ["owner/repo"],
"applies_to_all": false
},
"created_at": "2026-04-15T10:00:00Z",
"updated_at": "2026-05-09T21:00:00Z"
}
}