curl --silent --show-error --fail-with-body --request GET \
--url 'https://api.computer.stateset.app/api/v1/skills' \
--header "X-API-Key: $STATESET_COMPUTER_USE_API_KEY"
[
{
"key": "string",
"display_name": "Ada Lovelace",
"description": "Two-person tent, green — replacement for damaged pole set.",
"container_type": "string",
"container_version": "latest",
"triggers": [
"string"
],
"tags": [
"priority"
],
"created_at": "2026-08-31T14:22:05Z",
"updated_at": "2026-08-31T14:22:05Z"
}
]
Platform-wide skill catalog (read-only on v1)
List every published skill. Unscoped by tenant — same catalog for every caller…
GET
/
api
/
v1
/
skills
curl --silent --show-error --fail-with-body --request GET \
--url 'https://api.computer.stateset.app/api/v1/skills' \
--header "X-API-Key: $STATESET_COMPUTER_USE_API_KEY"
[
{
"key": "string",
"display_name": "Ada Lovelace",
"description": "Two-person tent, green — replacement for damaged pole set.",
"container_type": "string",
"container_version": "latest",
"triggers": [
"string"
],
"tags": [
"priority"
],
"created_at": "2026-08-31T14:22:05Z",
"updated_at": "2026-08-31T14:22:05Z"
}
]
Confirm your deployment before running this request. This page describes an API contract;
a published reference does not establish hosted availability. Check the dated
host report and obtain your deployment URL and credentials.
Replace the example host if your provisioned service uses a different URL.
key for stable
cursoring on SDK clients that paginate locally.
To attach a skill to a custom agent, copy its key into the
custom agent’s skills array (see POST /api/v1/custom-agents).
Response
SkillSummary[] — each element:
string
required
Stable lookup id; immutable once published.
string
required
Human-readable name for SDK / UI surfaces.
string
required
What this skill does, ≤1024 chars.
string,null
Container/runtime hint, when applicable (e.g. ‘docker’, ‘lambda’). None for generic / inline skills.
string
Version label for the underlying container image. Default:
'latest'.string[]
Activation triggers (e.g. ‘manual’, ‘on-tool-call’).
string[]
Categorization tags (e.g. ‘finance’, ‘compliance’).
string
required
string
required
Status codes
| Code | Meaning |
|---|---|
200 | Successful Response |
Using this contract
Read the source OpenAPI document for declared schemas and alternatives. This page also includes documented corrections from the spec overlays. Example IDs and values are illustrative; replace them with records from your workspace.curl --silent --show-error --fail-with-body --request GET \
--url 'https://api.computer.stateset.app/api/v1/skills' \
--header "X-API-Key: $STATESET_COMPUTER_USE_API_KEY"
[
{
"key": "string",
"display_name": "Ada Lovelace",
"description": "Two-person tent, green — replacement for damaged pole set.",
"container_type": "string",
"container_version": "latest",
"triggers": [
"string"
],
"tags": [
"priority"
],
"created_at": "2026-08-31T14:22:05Z",
"updated_at": "2026-08-31T14:22:05Z"
}
]
Last modified on September 21, 2026