Skip to Content
veriom

Create custom skill

Write a new skill for this workspace. It starts turned on.

POST
/v1/workspaces/{workspace_id}/skills/custom

Write a new skill for this workspace. It starts turned on.

Authorization

workspaceToken
headerAuthorizationBearer <vat_<opaque-token>>

Expiring, hashed workspace token with explicit scopes.

Path Parameters

workspace_id*Workspace Id
Formatuuid

Request Body

application/json
  1. body

A custom skill as a member writes it. Hard limits here only stop abuse; the product's limits are checked by custom_skill_problems so each is reported in place.

builds_on*array<string>
Itemsitems <= 20
category*Category
Value in"architecture""security""compliance""ai""cloud""delivery"
checks*array<string>
Itemsitems <= 20
funding?Funding
Default"any"
Value in"any""own_keys"
guardrails?array<string>
Itemsitems <= 20
question*Question
Lengthlength <= 2000
reads*array<>
Itemsitems <= 20
run_role?Run Role
Default"viewer"
Value in"viewer""developer""analyst""admin"
summary*Summary
Lengthlength <= 1000
surfaces*array<>
Itemsitems <= 10
title*Title
Lengthlength <= 200

Response Body

Successful Response

application/json
  1. response
available*Available

Whether the skill can run in this workspace right now.

builds_on*array<>

The reviewed skills this one is built on.

can_manage*Can Manage
can_run?Can Run

Whether the caller may run it now: turned on, available, and their role is at least its run_role.

Defaultfalse
category*Category
Value in"architecture""security""compliance""ai""cloud""delivery"
checks*array<string>

What the skill does, step by step.

definition?|

A custom skill's text as saved, for editing.

enabled*Enabled
export_targets*array<>
funding*Funding

own_keys skills run only when every model call uses the workspace's own keys.

Value in"any""own_keys"
guardrails*array<string>
id*Id
last_run_at?|null
last_run_id?|null
next_run_at?|null
problems?array<>

Why a saved custom skill needs an edit before it can run again.

question*Question

The question a run asks when the member adds none.

reads*array<>
run_role*Run Role
Value in"viewer""developer""analyst""admin"
schedule*Schedule
Value in"off""daily""weekly""after_audit"
source?Source

reviewed ships with Veriom; custom was written by this workspace.

Default"reviewed"
Value in"reviewed""custom"
summary*Summary
surfaces*array<>
title*Title
unavailable_reason?|null
version*Version
Example Request
curl -X POST 'https://api.veriom.ai/v1/workspaces/497f6eca-6276-4993-bfeb-53cbbbba6f08/skills/custom' \  -H 'Content-Type: application/json' \  -d '{  "builds_on": [    "string"  ],  "category": "architecture",  "checks": [    "string"  ],  "question": "string",  "reads": [    "entities"  ],  "summary": "string",  "surfaces": [    "ask"  ],  "title": "string"}'
Example Response
{  "available": true,  "builds_on": [    {      "description": "string",      "id": "string"    }  ],  "can_manage": true,  "can_run": false,  "category": "architecture",  "checks": [    "string"  ],  "definition": {    "builds_on": [      "string"    ],    "category": "architecture",    "checks": [      "string"    ],    "funding": "any",    "guardrails": [      "string"    ],    "question": "string",    "reads": [      "entities"    ],    "run_role": "viewer",    "summary": "string",    "surfaces": [      "ask"    ],    "title": "string"  },  "enabled": true,  "export_targets": [    "claude_skill"  ],  "funding": "any",  "guardrails": [    "string"  ],  "id": "string",  "last_run_at": "2019-08-24T14:15:22Z",  "last_run_id": "08df5d92-87b1-40a2-b1e7-a5977dea4efc",  "next_run_at": "2019-08-24T14:15:22Z",  "problems": [    {      "field": "string",      "message": "string"    }  ],  "question": "string",  "reads": [    {      "count": 0,      "kind": "entities",      "label": "string"    }  ],  "run_role": "viewer",  "schedule": "off",  "source": "reviewed",  "summary": "string",  "surfaces": [    "ask"  ],  "title": "string",  "unavailable_reason": "own_model_keys_required",  "version": "string"}