Skills
Create, discover, execute, and manage reusable capabilities for your agents.
Create Skill
Create a new skill record. Fails with an error if a skill with the same name already exists (optionally scoped to project_id).
Authorizations
API key authentication
Request Body
Unique identifier for the skill
Optional — scopes the uniqueness check to a project
Responses
Skill created, or a status:false error (e.g. duplicate name) — this endpoint returns 200 even on failure, check the status field
Whether the operation succeeded
/skillPlayground
Base URL
Authorization
Request body
Send a request to see the response here.
Retrieve Skill by name (query param)
Alternate lookup form: GET /skill?name=
Authorizations
API key authentication
Parameters
Query Parameters
Comma-separated field projection, e.g. _id,name,title
Responses
Skill data, or status:false if not found
Whether the operation succeeded
/skillPlayground
Base URL
Authorization
Variables
Send a request to see the response here.
Get Skill by ID
Retrieve a skill by its MongoDB _id.
Authorizations
API key authentication
Parameters
Path Parameters
Query Parameters
Comma-separated field projection
Responses
Skill data, or status:false if not found
Whether the operation succeeded
/skill/id/{item_id}Playground
Base URL
Authorization
Variables
Send a request to see the response here.
Get Skill by name
Retrieve a skill by its unique name.
Authorizations
API key authentication
Parameters
Path Parameters
Query Parameters
Responses
Skill data, or status:false if not found
Whether the operation succeeded
/skill/{name}Playground
Base URL
Authorization
Variables
Send a request to see the response here.
Update Skill
Update a skill's fields. updated timestamp is set automatically.
Authorizations
API key authentication
Parameters
Path Parameters
Request Body
Any subset of skill fields to set
Responses
status:true with a confirmation message, or status:false if not found
Whether the operation succeeded
/skill/{item_id}Playground
Base URL
Authorization
Variables
Request body
Send a request to see the response here.
Delete Skill
Delete a skill by its MongoDB _id.
Authorizations
API key authentication
Parameters
Path Parameters
Responses
status:true with the deleted id, or status:false if not found
Whether the operation succeeded
/skill/{item_id}Playground
Base URL
Authorization
Variables
Send a request to see the response here.
Search Skills
Paginated search over skills in the project.
Authorizations
API key authentication
Request Body
MongoDB-style filter, e.g. {"name": {"$regex": "sync", "$options": "i"}}
[field, direction] e.g. ["name", 1]
110Responses
Paginated skill list
Whether the operation succeeded
/skill/searchPlayground
Base URL
Authorization
Request body
Send a request to see the response here.
Execute Skill by ID
Execute a skill by its MongoDB _id. Always dispatched via a Celery task; pass agent-config.delay: false to block and wait up to 300s for the result instead of getting a scheduled task id back immediately.
Authorizations
API key authentication
Parameters
Path Parameters
Request Body
Responses
Scheduled (default) returns a skill_run_id + task_id; delay:false returns the actual result with skill_run_id attached
Whether the operation succeeded
/skill/executor/id/{item_id}Playground
Base URL
Authorization
Variables
Request body
Send a request to see the response here.
Execute Skill by name
Same as Execute Skill by ID, but resolved by skill name first.
Authorizations
API key authentication
Parameters
Path Parameters
Request Body
Responses
Same shape as Execute Skill by ID
Whether the operation succeeded
/skill/executor/{name}Playground
Base URL
Authorization
Variables
Request body
Send a request to see the response here.