Write SKILL.md
curl --request PUT \
--url http://127.0.0.1:8765/v1/workspaces/{workspace_id}/skill-md \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"path": "/SKILL.md"
}
'import requests
url = "http://127.0.0.1:8765/v1/workspaces/{workspace_id}/skill-md"
payload = { "path": "/SKILL.md" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({path: '/SKILL.md'})
};
fetch('http://127.0.0.1:8765/v1/workspaces/{workspace_id}/skill-md', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));---
name: workspace-commands
description: The CLIs registered in this workspace and how to call them.
---
# Available commands
No CLIs are registered.
Agent Instructions
Write SKILL.md
PUT
/
v1
/
workspaces
/
{workspace_id}
/
skill-md
Write SKILL.md
curl --request PUT \
--url http://127.0.0.1:8765/v1/workspaces/{workspace_id}/skill-md \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"path": "/SKILL.md"
}
'import requests
url = "http://127.0.0.1:8765/v1/workspaces/{workspace_id}/skill-md"
payload = { "path": "/SKILL.md" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({path: '/SKILL.md'})
};
fetch('http://127.0.0.1:8765/v1/workspaces/{workspace_id}/skill-md', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));---
name: workspace-commands
description: The CLIs registered in this workspace and how to call them.
---
# Available commands
No CLIs are registered.
Write SKILL.md to the specified path for the selected session.
See error examples and recovery steps. The complete OpenAPI contract includes every response schema.
---
name: workspace-commands
description: The CLIs registered in this workspace and how to call them.
---
# Available commands
No CLIs are registered.
Errors
Errors
| Status | Meaning |
|---|---|
400 | The request is malformed: the body is not JSON (invalid_json) or not a JSON object, a field is missing (missing_field), unknown (unknown_field) or has a wrong value (invalid_value), or the request is otherwise invalid (invalid_request). param names the field at fault. |
401 | The token is missing or wrong (unauthorized). |
404 | The workspace, session, job, file or route does not exist, or the caller may not see it (not_found). |
429 | Past a rate limit (rate_limited), or a new session past max_sessions (session_limit). |
Authorizations
Query Parameters
Response
200 - text/markdown
Generated SKILL.md document.
The response is of type string.