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
| Method | Path | Description |
|---|---|---|
GET | /ai-assistant-skills | List skills |
GET | /ai-assistant-skills/:id | Get a skill |
POST | /ai-assistant-skills | Create a skill |
PATCH | /ai-assistant-skills/:id | Update a skill |
DELETE | /ai-assistant-skills/:id | Delete a skill |
Reads are limited to your API key's organization.
The skill object
json
Fields
| Field | Type | Description |
|---|---|---|
id | integer | Read-only. Unique ID. |
organization_id | integer | Organization that owns the skill. Required on create with an API key (your key's organization). |
assistant_id | integer | Required. AI assistant that uses the skill; must belong to the same organization. |
name | string | Required. Skill name. |
content | string | Required. Instructions or knowledge, in Markdown or plain text. |
when_to_use | string | Required. Tells the assistant when to load the skill. |
created_at | string (date-time) | Read-only. Creation timestamp. |
updated_at | string (date-time) | Read-only. Last update timestamp. |
deleted_at | string (date-time) | null | Read-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.