v1

latestOpenAPI 3.0.02026-07-26870415.2 KB

skills

Patch skill

Updates mutable workspace agent skill fields. Requires a token with write access.

patch/v1/skills/{id}

Path parameters

idstring required

Skill id.

Example:ks77c0dy0mgdpzmqz6tesry8w184002s

Query parameters

workspace_idstring

Optional workspace override. If omitted, Conduit resolves the skill's workspace automatically.

Example:j57demo8f8x7c9v0n2q4r6t8y1u3i5o

Request body

namestring

descriptionstring

bodystring

allowed_toolsstring[] nullable

tagsstring[] nullable

enabledboolean

Example request

{
  "name": "reservation-policy",
  "tags": [
    "policy",
    "reservations"
  ],
  "enabled": false
}

Response

Skill updated

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"
  }
}