Sign in

v1

latestOpenAPI 3.0.02026-07-26870415.2 KB
skills

Create skill

Creates a workspace agent skill. Requires a token with write access.

post/v1/skills

Request body

workspace_idstring required
namestring required
descriptionstring required
bodystring required
allowed_toolsstring[]
tagsstring[]
enabledboolean
auto_assign_to_existing_v2_agentsboolean

Example request

{
  "workspace_id": "j57demo8f8x7c9v0n2q4r6t8y1u3i5o",
  "name": "booking-policy",
  "description": "Use this skill for refund and cancellation questions.",
  "body": "Guests may cancel up to 48 hours before check-in for a full refund.",
  "allowed_tools": [
    "convex_get_booking"
  ],
  "tags": [
    "policy",
    "refunds"
  ],
  "enabled": true,
  "auto_assign_to_existing_v2_agents": false
}

Response

Skill created

Example response

{
  "data": {
    "id": "ks77c0dy0mgdpzmqz6tesry8w184002s",
    "workspace_id": "j57demo8f8x7c9v0n2q4r6t8y1u3i5o",
    "name": "booking-policy",
    "description": "Use this skill for refund and cancellation questions.",
    "body": "Guests may cancel up to 48 hours before check-in for a full refund.",
    "allowed_tools": [
      "convex_get_booking"
    ],
    "tags": [
      "policy",
      "refunds"
    ],
    "enabled": true,
    "created_at": "2026-04-01T17:22:10.000Z",
    "updated_at": "2026-04-03T03:14:15.000Z"
  }
}