Skip to content

Get a specific capability

GET
/v1/capabilities/{capability_id}
capability_id
required
string

Capability ID

Capability found

Wrapper that adds API and UI links to a serialized resource.

Uses self_url (not url) for the API link to avoid collision with resources that already have a url field (e.g. McpServer).

object
agent_count

Number of active agents referencing this capability in the org.

integer format: int64
category

Category for grouping in UI

string | null
config_schema

JSON Schema for capability-specific per-agent config.

object
config_ui_schema

React-jsonschema-form uiSchema hints for rendering config_schema.

object
dependencies

IDs of capabilities that this capability depends on. When this capability is selected, its dependencies are automatically included.

Array<string>
description
required

Description of what this capability provides

string
docs_slug

Slug under https://dev.everruns.com/capabilities/ when public docs exist.

string | null
features

UI feature strings this capability contributes to. Multiple capabilities can contribute the same feature.

Array<string>
harness_count

Number of active harnesses referencing this capability in the org.

integer format: int64
icon

Icon name (for UI rendering)

string | null
id
required

Unique capability identifier

string
is_mcp

Whether this is an MCP server capability (for UI badge)

boolean
is_skill

Whether this is an Agent Skill capability (for UI badge)

boolean
name
required

Display name

string
risk_level

TM-AGENT-005: Risk level. High-risk capabilities require admin approval.

string
Allowed values: low medium high
status
required

Current status

string
system_prompt

System prompt addition contributed by this capability

string | null
tool_definitions

Tool definitions provided by this capability

Array<object>
object
self_url
required

Full API endpoint URL for this resource.

string
ui_link
required

Alias for view_url, used by command and MCP outputs.

string
view_url
required

Full UI URL for viewing this resource.

string

Capability not found

Standard error response for API endpoints.

object
error
required

Error message describing what went wrong.

string

Internal server error

Standard error response for API endpoints.

object
error
required

Error message describing what went wrong.

string