Skip to main content
PUT
Update a skill

Authorizations

Authorization
string
header
required

Your Reason API key from Settings > API. New keys use reason_; legacy ara_ keys remain accepted. Keys are capability-scoped: run, mcp:read, mcp:write, secrets:read, secrets:write, sessions:read, sessions:debug, knowledge:read, memory:read, memory:write, skills:read, skills:write, repos:read, repos:write, reviews:read, reviews:write, deployment:read, analytics:read, org:read, org:write, attachments:read, attachments:write, guardrails:read, guardrails:write, automations:read, automations:write, agent_auth:read. mcp:write manages MCP server configuration only; it does not authorize remote MCP-tool execution. sessions:debug is privileged: it expands diagnostic session events only for organization owners/admins.

Path Parameters

orgId
string
required

Organization id or slug. Resolve it with GET /v3/self.

skillId
string
required

Body

application/json

All fields optional. Only supplied fields are changed.

name
string
description
string

Describe what the skill does and when an agent should use it. Ara uses this description for semantic selection.

instructions
string
activation_keywords
string[]

Optional search aliases retained for compatibility. They improve explicit search but do not activate the skill automatically.

is_enabled
boolean

Response

Updated.

skill_id
string
name
string
description
string

What the skill does and when an agent should use it. Ara uses this description for semantic selection.

instructions
string
activation_keywords
string[]

Optional search aliases retained for compatibility. They do not activate the skill automatically.

is_enabled
boolean
author
string
provenance
enum<string>
Available options:
authored,
skills_sh,
git,
agent_plugin,
curated_integration,
builtin
created_by
string | null
created_at
string<date-time>
updated_at
string<date-time>