Skip to main content
POST
/
workspaces
/
{workspace_id}
/
agent
/
skills
Error
A valid request URL is required to generate request examples
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "workspace_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "slug": "<string>",
  "draft_revision": 123,
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "is_draft_publishable": true,
  "draft_file_count": 123,
  "description": "<string>",
  "current_version_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "deleted_at": "2023-11-07T05:31:56Z",
  "current_version": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "skill_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "workspace_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "version": 123,
    "manifest_sha256": "<string>",
    "file_count": 123,
    "total_size_bytes": 123,
    "name": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "description": "<string>"
  },
  "draft_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

workspace_id
string<uuid>
required

Body

application/json

Payload for creating a new logical skill.

name
string
required
Required string length: 1 - 64
Pattern: ^[a-z0-9-]+$
description
string | null
Maximum string length: 4000

Response

Successful Response

Full response model for a workspace skill.

id
string<uuid>
required
workspace_id
string<uuid>
required
name
string
required
slug
string
required
draft_revision
integer
required
created_at
string<date-time>
required
updated_at
string<date-time>
required
is_draft_publishable
boolean
required
draft_file_count
integer
required
description
string | null
current_version_id
string<uuid> | null
deleted_at
string<date-time> | null
current_version
SkillVersionReadMinimal · object | null

Summary response model for published skill versions in list endpoints.

draft_validation_errors
SkillValidationErrorDetail · object[]