Orq MCP is live: Use natural language to interrogate traces, spot regressions, and experiment your way to optimal AI configurations. Available in Claude Desktop, Claude Code, Cursor, and more. Start now →
Platform APIs
Router APIs
Enterprise APIs (coming soon)
Update a skill
Updates mutable skill fields. Omitted optional fields keep their current values. Repeated fields such as tags replace the existing collection when provided.
curl --request PATCH \
--url https://api.orq.ai/v2/skills/{skill_id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"skill_id": "<string>",
"display_name": "<string>",
"description": "<string>",
"tags": [
"<string>"
],
"path": "<string>",
"instructions": "<string>",
"project_id": "<string>"
}
'{
"skill": {
"skill_id": "<string>",
"display_name": "<string>",
"description": "<string>",
"tags": [
"<string>"
],
"project_id": "<string>",
"path": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"created_by_id": "<string>",
"updated_by_id": "<string>",
"instructions": "<string>",
"version": "<string>"
}
}Documentation Index
Fetch the complete documentation index at: https://docs.orq.ai/llms.txt
Use this file to discover all available pages before exploring further.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Skill ID to update.
Body
Skill ID to update.
New workspace-unique display name. Omit to keep the current name.
New description. Omit to keep the current description.
Replacement tag list. Leave empty to clear tags.
New project path. Omit to keep the current path.
New instruction body. Omit to keep the current instructions.
New containing project. Omit to keep the current project.
Response
OK
Updated skill.
Show child attributes
Show child attributes
Was this page helpful?
curl --request PATCH \
--url https://api.orq.ai/v2/skills/{skill_id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"skill_id": "<string>",
"display_name": "<string>",
"description": "<string>",
"tags": [
"<string>"
],
"path": "<string>",
"instructions": "<string>",
"project_id": "<string>"
}
'{
"skill": {
"skill_id": "<string>",
"display_name": "<string>",
"description": "<string>",
"tags": [
"<string>"
],
"project_id": "<string>",
"path": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"created_by_id": "<string>",
"updated_by_id": "<string>",
"instructions": "<string>",
"version": "<string>"
}
}