# GET /v1/capabilities/declarative - List persisted declarative resources.
Source:
GET
/v1/capabilities/declarative
Select code samplecURL (shell:curl)
```js
const url = 'https://app.everruns.com/api/v1/capabilities/declarative';
const options = {method: 'GET'};
try {
const response = await fetch(url, options);
const data = await response.json();
console.log(data);
} catch (error) {
console.error(error);
}
```
```sh
curl --request GET \
--url https://app.everruns.com/api/v1/capabilities/declarative
```
* Production APIapp.everruns.com/api/v1/capabilities/declarative
## Parameters
### Query Parameters
**search**
string
Search by unique name, display name, or description
**include\_archived**
boolean
Include archived declarative capabilities
## Responses
### 200
Persisted declarative capability resources
Media typeapplication/json
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). The `allowed_actions` array carries state-aware hypermedia links — empty (and omitted from the wire shape) until the underlying resource opts into the convention by overriding `ResourceUrlable::allowed_actions`.
object
**archived\_at**
Timestamp when this resource was archived, if any (RFC 3339).
string | null format: date-time
**capability\_id**
required
Runtime capability reference. Agents and harnesses may use this or the plain unique name.
string
**created\_at**
required
Timestamp when this resource was created (RFC 3339).
string format: date-time
**definition**
required
Declarative capability payload: system prompt, skills, starter files, MCP servers, and metadata.
object
**definition\_error**
Why the stored definition could not be parsed, when it could not be.
Present only for a corrupt row. The capability keeps its identity columns so a surface can name what is broken, but `definition` is the inert default and `definition.status` reports `retired`, so nothing reads it as a usable capability.
string | null
**deleted\_at**
Timestamp when this resource was soft-deleted, if any (RFC 3339).
string | null format: date-time
**description**
required
Short summary shown in pickers, search results, and API listings.
string
**display\_name**
Human-facing label shown in the UI. Defaults to `name` when omitted.
string | null
**id**
required
Public resource ID for this persisted declarative capability.
string
**name**
required
Stable unique name used in capability refs. Lowercase letters, numbers, and underscores.
string
**status**
required
Lifecycle state for the resource: active, disabled, archived, or deleted.
string
**updated\_at**
required
Timestamp when this resource was last updated (RFC 3339).
string format: date-time
**allowed\_actions**
State-aware hypermedia actions the caller can take on this resource next (e.g. `cancel`, `events`, `update`). Omitted from the wire shape when empty so resources that haven’t opted into the convention don’t grow their payloads.
Array\