x-cpod-domain: skills

Skills

Platform skill registry — reusable, versioned capabilities that agents and workflows can invoke.

Try in explorer client.skills

Skill

A versioned, reusable capability that can be executed by agents or workflows.

REST path/api/v1/skills

Operations

listgetcreateupdatedeleterun

SDK

// list — returns only your records; add filters/search:
await client.skills.list()

// create:
await client.skills.create({
  id: "rec_01HXEXAMPLE",
  tenant_id: "example tenant_id",
  created_at: "2026-01-01T00:00:00Z",
  updated_at: "2026-01-01T00:00:00Z",
  name: "example name",
  app_id: "example app_id",
})

Field	Type	Description
id*	uuid	Server-assigned ULID with type prefix (e.g. per_…).
tenant_id*	string	Tenant scope — auto-stamped from the caller's JWT.
app_id	string	App scope. Stamped ONLY when the caller's JWT was minted for a specific Application (integration API keys). Absent for human-user sessions. Filters reads when present.
created_at*	date-time	Server stamp.
updated_at*	date-time	Server stamp; updated on every patch.
created_by	uuid→User	User id from the caller's JWT (sub).
updated_by	uuid→User	User id from the last writer's JWT (sub).
source	string	Provenance tag — defaults to 'edm'.
source_type	enum	Where the write originated. Defaults to 'api'.`frontendbackendserversystemapi`
is_deleted	boolean	Soft-delete flag. Excluded from default list queries.
deleted_at	date-time	Stamped when soft-deleted; null otherwise.
deleted_by	uuid→User	User id who soft-deleted; null otherwise.
schema_version	number	Document schema version. Bumped on incompatible writes.
name*	string	Skill name (unique per tenant).
description	string	Human-readable skill description.
version	string	Semantic version (e.g., '1.2.3').
type	enum	Skill implementation type.`codepromptworkflowtool`
status	enum	Skill lifecycle status.`activedeprecatedarchived`
input_schema	json	JSON Schema for skill input parameters.
output_schema	json	JSON Schema for skill output.
config	json	Skill configuration and runtime parameters.
dependencies	json	List of other skills this skill depends on.
permissions	json	Required permissions to execute this skill.

Docs

Skill