AI Assistant Skills API

Manage reusable knowledge blocks attached to AI assistants.

Overview

Skills let an assistant load focused instructions only when they are relevant. The assistant configuration page uses skills for detailed procedures, policies, product notes, or playbooks that should not always be placed directly in the main assistant instructions.

Base Endpoint: /ai-assistant-skills

Skill Object

json

Fields

FieldTypeDescription
idNumberUnique skill ID
assistant_idNumberAI assistant that owns the skill
organization_idNumberOrganization that owns the skill
nameStringHuman-readable skill name
contentStringSkill instructions or knowledge content
when_to_useStringGuidance that tells the assistant when this skill should be applied
created_atStringCreation timestamp
updated_atStringLast update timestamp

Related Documentation

Use the AI Assistants API to create and configure assistants. Skills are managed as their own resource and referenced by assistant_id.

Report an issue with this documentation

Please log in to report issues with our documentation.