Update a skill | Ara Documentation

{
  "skill_id": "a1b2c3d4-e5f6-7890-ab12-cd34ef567890",
  "name": "Code Review Assistant",
  "description": "Automates code review tasks by analyzing pull requests and providing feedback.",
  "instructions": "Review the code changes for style, correctness, and potential bugs. Provide suggestions inline.",
  "activation_keywords": [
    "code review",
    "pull request",
    "review assistant"
  ],
  "is_enabled": true,
  "author": "Jane Doe",
  "created_by": "jane.doe@example.com",
  "created_at": "2024-01-15T09:30:00Z",
  "updated_at": "2024-01-15T09:30:00Z"
}

Partial update. Send only the fields you want to change.

_{Scope: skills:write}

Authentication

AuthorizationBearer

Your ara_ API key from Settings > Ara API. Keys are capability-scoped: run, plugins:read, secrets:read, secrets:write, sessions:read, knowledge:read, repos:read, repos:write, reviews:read, reviews:write, analytics:read, org:read, org:write, attachments:read, attachments:write, plugins:write, guardrails:read, guardrails:write.

Path parameters

orgIdstringRequired

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

skillIdstringRequired

Request

This endpoint expects an object.

namestringOptional

descriptionstringOptional

instructionsstringOptional

activation_keywordslist of stringsOptional

is_enabledbooleanOptional

Response

Updated.

skill_idstring

namestring

descriptionstring

instructionsstring

activation_keywordslist of strings

is_enabledboolean

authorstring

created_bystring or null

created_atdatetime

updated_atdatetime

Errors

404

Not Found Error

$	curl -X PUT https://api.ara.so/v3/organizations/orgId/skills/skillId \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{}'