Skip to main content
POST
Attach a skill to a scenario

Authorizations

Authorization
string
header
required

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

Path Parameters

scenarioId
string<uuid>
required

Scenario UUID.

id
string<uuid>
required

Skill UUID.

Body

application/json
position
integer
default:0
Required range: x >= 0

Response

Already attached — the existing attachment row is returned.

Links a skill to a scenario. The trigger reaches the agent only when active = true.

id
string<uuid>
required
Example:

"3a2b1c0d-4e5f-6789-abcd-ef0123456789"

scenario_id
string<uuid>
required
Example:

"7e3b9c2a-1d4f-4a1b-bdc6-9c8b2d3f4e5a"

skill_id
string<uuid>
required
Example:

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

active
boolean
default:true
required

Set false to keep the attachment but hide the skill from the agent.

Example:

true

position
integer
default:0

Order the triggers are listed in. Lower first.

Required range: x >= 0
Example:

0

skill
object

Embedded skill definition. Returned on list/attach/update responses.

created_at
string<date-time>
Example:

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

updated_at
string<date-time>
Example:

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