Skip to navigation
Configuration API (Alpha)Assistant skills

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 headers

x-trace-idstringOptional
A unique identifier used to trace your request within the Moveworks system

Response

The Skill
idstringRead-onlyformat: "uuid"

Unique identifier of the Skill, assigned by the server. Use it in a productivity assistant’s skill_ids.

namestringRead-only

Skill name from the bundle’s SKILL.md. Unique in your organization, and fixed once the Skill is created.

versionobject
The version of a stored document.
descriptionstringOptionalRead-only

Skill description from the bundle’s SKILL.md.

surfaceslist of stringsOptionalRead-only

Where the Skill is available, from the surfaces list in the bundle’s SKILL.md, for example slack. An empty list means everywhere.

updated_timedatetimeOptionalRead-only
When the Skill was last updated.
updated_bystringOptionalRead-only
Who last updated the Skill.

Errors

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