Skip to navigation

List skills

View as Markdown
Returns every Skill registered in your organization as a JSON array.

Authentication

AuthorizationBearer

JWT bearer token authentication. Include the Configuration API key in the Authorization header as ‘Bearer <token>’.

Response

The Skills in your organization
idstringOptionalRead-only
Unique identifier of this skill, assigned by the server.
file_idstringOptional>=1 character

Files API id of the uploaded .zip or .skill bundle (purpose CONFIGURATIONS_ASSISTANT_SKILL). Required on create; on update it replaces the bundle. Write-only: the staged upload is consumed on registration and expires, so reads never return a file_id.

namestringOptionalRead-only
Skill name from the bundle's SKILL.md. Unique within the organization and fixed after creation.
descriptionstringOptionalRead-only
Skill description from the bundle's SKILL.md.
surfaceslist of stringsOptionalRead-only

Surfaces the skill is available on, from the bundle’s SKILL.md (e.g. slack, movewebchat:assistant). Empty means every surface.

updated_timedatetimeOptionalRead-only
When the skill was last updated.
updated_bystringOptionalRead-only
Who last updated the skill.
versionobjectOptional
Document version. On update, send back the num from your last read.

Errors

401
Unauthorized Error
403
Forbidden Error
429
Too Many Requests Error
500
Internal Server Error