Skip to content

List persisted declarative resources.

GET
/v1/capabilities/declarative
search
string

Search by unique name, display name, or description

include_archived
boolean

Include archived declarative capabilities

Persisted declarative capability resources

Response wrapper for list endpoints. All list endpoints return responses wrapped in a data field.

object
data
required

Array of items returned by the list operation.

Array

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
archived_at
string | null format: date-time
capability_id
required

Runtime capability reference. Agents and harnesses may use this or the plain unique name.

string
Example
declarative:research_pack
created_at
required
string format: date-time
definition
required

Declarative capability payload: system prompt, skills, starter files, MCP servers, and metadata.

object
deleted_at
string | null format: date-time
description
required

Short summary shown in pickers, search results, and API listings.

string
Example
Adds research instructions, starter files, and MCP tools.
display_name

Human-facing label shown in the UI. Defaults to name when omitted.

string | null
Example
Research Pack
id
required

Public resource ID for this persisted declarative capability.

string
Example
cap_01933b5a000070008000000000000001
name
required

Stable unique name used in capability refs. Lowercase letters, numbers, and underscores.

string
Example
research_pack
status
required

Lifecycle state for the resource: active, disabled, archived, or deleted.

string
Example
active
updated_at
required
string format: date-time
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