AI Assistant Skills

A skill is a focused block of knowledge or procedure attached to an AI assistant. The assistant loads it only when when_to_use matches the situation, which keeps the main instructions short.

Endpoints

MethodPathDescription
GET/ai-assistant-skillsList skills
GET/ai-assistant-skills/:idGet a skill
POST/ai-assistant-skillsCreate a skill
PATCH/ai-assistant-skills/:idUpdate a skill
DELETE/ai-assistant-skills/:idDelete a skill

Reads are limited to your API key's organization.

The skill object

json

Fields

FieldTypeDescription
idintegerRead-only. Unique ID.
organization_idintegerOrganization that owns the skill. Required on create with an API key (your key's organization).
assistant_idintegerRequired. AI assistant that uses the skill; must belong to the same organization.
namestringRequired. Skill name.
contentstringRequired. Instructions or knowledge, in Markdown or plain text.
when_to_usestringRequired. Tells the assistant when to load the skill.
created_atstring (date-time)Read-only. Creation timestamp.
updated_atstring (date-time)Read-only. Last update timestamp.
deleted_atstring (date-time) | nullRead-only. Set when the skill is deleted.

Creating, updating or deleting a skill of a voice assistant marks the assistant's voice configuration for re-sync (telnyx_ai_assistant_config.sync_status: "pending"), except on the openai_realtime_sip runtime.

Related

Report an issue with this documentation

Please log in to report issues with our documentation.