Skip to navigation

Get skill

View as Markdown
Returns one Skill.

Authentication

AuthorizationBearer

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

Path parameters

idstringRequiredformat: "uuid"

The id of the Skill, as returned when it was registered or listed.

Response

The Skill
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
404
Not Found Error
429
Too Many Requests Error
500
Internal Server Error