Skip to main content
PATCH
/
workspaces
/
{workspace_id}
/
agent
/
skills
/
{skill_id}
/
draft
Error
A valid request URL is required to generate request examples
{
  "skill_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "skill_name": "<string>",
  "draft_revision": 123,
  "is_publishable": true,
  "name": "<string>",
  "description": "<string>",
  "files": [
    {
      "path": "<string>",
      "blob_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "sha256": "<string>",
      "size_bytes": 123,
      "content_type": "<string>"
    }
  ],
  "validation_errors": [
    {
      "code": "<string>",
      "message": "<string>",
      "path": "<string>"
    }
  ]
}
{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}

Authorizations

fastapiusersauth
string
cookie
required

Path Parameters

skill_id
string<uuid>
required
workspace_id
string<uuid>
required

Body

application/json

Optimistic-concurrency draft mutation request.

base_revision
integer
required
Required range: x >= 0
operations
(SkillDraftUpsertTextFileOp · object | SkillDraftAttachUploadedBlobOp · object | SkillDraftDeleteFileOp · object | SkillDraftMoveFileOp · object)[]
required
Minimum array length: 1

Replace or create a text file in the skill draft.

Response

Successful Response

Current mutable draft state for a skill.

skill_id
string<uuid>
required
skill_name
string
required
draft_revision
integer
required
is_publishable
boolean
required
name
string | null
description
string | null
files
SkillFileEntry · object[]
validation_errors
SkillValidationErrorDetail · object[]