Skip to main content
POST
Add or update Atlas AI project skills

Authorizations

Authorization
string
header
required

Access token issued by the CDF project's configured identity provider. Access token must be an OpenID Connect token, and the project must be configured to accept OpenID Connect tokens. Use a header key of 'Authorization' with a value of 'Bearer $accesstoken'. The token can be obtained through any flow supported by the identity provider.

Query Parameters

overwrite
boolean
default:false

If false (default), returns 409 Conflict when any requested skill is still referenced by an agent. If true, the skill body is saved regardless.

Body

application/json
items
SkillCreationRequestItem · object[]
required

A list of skills to create or update. Currently, only one skill can be sent per request. The overwrite query parameter on POST /skills controls whether a 409 is raised when agents still reference the skill; it is not part of this JSON body.

Required array length: 1 element

Response

Successful Response

items
SkillListResponseItem · object[]
required

Skills returned with full detail, including Markdown instruction content (e.g. create or fetch-by-id responses). For POST /skills, items match the request items order and count.

Last modified on October 6, 2026