Skills

Read the prompt presets available to a workspace.

Skills are prompt presets defined in the console. This endpoint tells you which ones a workspace can use, so you can offer them as options and pass one as skill_id when asking a question.

List skills

Returns the union of skills scoped to this workspace and skills scoped to its app — an app-level skill is usable from every workspace beneath it.

GET/workspaces/{workspace_id}/skills/

Field	Type	Description
`id`	`uuid`	Unique identifier, assigned by the server.
`title`	`string`	Display name of the skill.
`description`	`string`	What the skill is for.
`core_prompt`	`string`	The instruction appended to the system prompt when the skill is used.
`scope`	`global \| application \| workspace`	Where the skill is defined — globally, on the app, or on one workspace.
`category`	`string \| null`	Vertical the global skill belongs to. Null for user-authored skills.

cURL

JavaScript

Python

curl "https://api.daneshyar.info/api/v1/workspaces/8f14e45f-ceea-467a-9f4c-1a2b3c4d5e6f/skills/" \
  -H "X-API-Key: dk_live_9f3aC2xQ7mB1vT8sE4nK6pR0jY5wZ2hL"

Response

{
  "status": "ok",
  "data": {
    "count": 1,
    "next": null,
    "previous": null,
    "results": [
      {
        "id": "0a7f3d52-8e61-4b90-ac35-6d2f19c847be",
        "title": "Clinical summary",
        "description": "Answer as a concise clinical summary with dosages called out.",
        "core_prompt": "Summarise for a practising clinician. Always surface dosages...",
        "category": "health",
        "application_id": "c4e18b6a-9d70-4f21-8b53-2a6f0e7c9d84",
        "workspace_id": null,
        "scope": "application",
        "created_at": "2026-08-01T12:00:00.000Z",
        "updated_at": "2026-08-01T12:00:00.000Z"
      }
    ]
  }
}

This endpoint is read-only. Skills are authored in the console; there is no create, update or delete on the customer API.

id

uuid

Unique identifier, assigned by the server.

title

string

Display name of the skill.

description

string

What the skill is for.

core_prompt

string

The instruction appended to the system prompt when the skill is used.

scope

global | application | workspace

Where the skill is defined — globally, on the app, or on one workspace.

category

string | null

Vertical the global skill belongs to. Null for user-authored skills.

{ "status": "ok", "data": { "count": 1, "next": null, "previous": null, "results": [ { "id": "0a7f3d52-8e61-4b90-ac35-6d2f19c847be", "title": "Clinical summary", "description": "Answer as a concise clinical summary with dosages called out.", "core_prompt": "Summarise for a practising clinician. Always surface dosages...", "category": "health", "application_id": "c4e18b6a-9d70-4f21-8b53-2a6f0e7c9d84", "workspace_id": null, "scope": "application", "created_at": "2026-08-01T12:00:00.000Z", "updated_at": "2026-08-01T12:00:00.000Z" } ] } }