Skip to main content
GET
Get a skill

Authorizations

Authorization
string
header
required

API key from waterr.ai/settings?tab=api-keys. Send as Authorization: Bearer wai_<your_key>.

Path Parameters

id
string<uuid>
required

Skill UUID.

Response

The skill.

An invokable instruction pack. Only the one-line trigger sits in the agent's prompt each turn; the full instructions load when the agent invokes the skill mid-meeting and are dropped when the flow completes.

id
string<uuid>
required
Example:

"9f0e1d2c-3b4a-5968-8776-655443322110"

name
string
required

Identifier the agent passes to invoke_skill. Unique per account.

Maximum string length: 64
Pattern: ^[a-zA-Z0-9_-]{1,64}$
Example:

"book_demo"

trigger
string
required

One line describing WHEN to invoke this skill. Lives in the base prompt on every turn — keep it short and specific.

Maximum string length: 500
Example:

"book_demo: when the participant asks to see the product live."

instructions
string
required

The instruction pack, delivered to the agent only after it invokes the skill.

Maximum string length: 8000
Example:

"Confirm intent first. Then collect their preferred time and timezone, one question per turn, and call schedule_demo once."

active
boolean
default:true
required

Account-level kill-switch for the definition.

Example:

true

membership_id
string<uuid>
Example:

"a1b2c3d4-e5f6-7890-abcd-ef0123456789"

gated_tool_names
string[]

Custom-function names that refuse to execute until this skill is invoked. [] means the skill is purely behavioural.

Maximum array length: 20
Pattern: ^[a-zA-Z0-9_-]{1,64}$
Example:
scenarios
object[]

Scenarios this skill is attached to. Returned only on the single-skill read.

created_at
string<date-time>
Example:

"2026-09-10T09:00:00.000Z"

updated_at
string<date-time>
Example:

"2026-09-10T09:00:00.000Z"