List all non-archived apps

GET

/v1/apps

const url = 'https://app.everruns.com/api/v1/apps';
const options = {method: 'GET'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://app.everruns.com/api/v1/apps

Parameters

Query Parameters

search

string | null

Search by name or description (case-insensitive substring match).

include_archived

boolean | null

Include archived apps. Deleted apps never appear in lists.

Responses

200

List of apps

application/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).

object

agent_id

Optional ID of the agent to use (format: agent_{32-hex}).

string | null

agent_identity_id

Optional virtual identity that represents the app in unattended/channel execution.

string | null

agent_version_id

Pinned agent version. Required when policy is pinned.

string | null

agent_version_policy

Version resolution policy for the optional agent.

string

Allowed values: default latest pinned

archived_at

Timestamp when the app was archived.

string | null format: date-time

channels

Distribution channels attached to this app.

Array<object>

A single distribution channel attached to an App. Each channel has its own type, config, and lifecycle status.

object

channel_config

Channel-specific configuration (validated per channel type).

channel_type

required

Channel type (e.g. slack).

string

Allowed values: slack ag_ui schedule webhook a2a fcp

created_at

required

Timestamp when this channel was created.

string format: date-time

enabled

Whether this channel is enabled.

boolean

required

External identifier (appchan_<32-hex>). Shown as “id” in API.

string

updated_at

required

Timestamp when this channel was last updated.

string format: date-time

created_at

required

Timestamp when the app was created.

string format: date-time

deleted_at

Timestamp when the app was deleted.

string | null format: date-time

description

Human-readable description of what the app does.

string | null

effective_owner

One of:

null
object

null

harness_id

required

ID of the harness to use (format: harness_{32-hex}).

string

required

External identifier (app_<32-hex>). Shown as “id” in API.

string

name

required

Display name of the app.

string

owner

One of:

null
object

null

owner_principal_id

required

Owning principal for this app.

string

published_at

Timestamp when the app was last published.

string | null format: date-time

resolved_owner_user_id

Denormalized effective human owner of the owning principal lineage.

string | null format: uuid

status

required

Current lifecycle status.

string

Allowed values: draft published archived deleted

updated_at

required

Timestamp when the app was last updated.

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

Example

{
  "data": [
    {
      "agent_id": "agent_01933b5a00007000800000000000001",
      "agent_identity_id": "identity_01933b5a00007000800000000000001",
      "agent_version_id": "agentver_01933b5a00007000800000000000001",
      "agent_version_policy": "default",
      "channels": [
        {
          "channel_type": "slack",
          "id": "appchan_01933b5a000070008000000000000001"
        }
      ],
      "effective_owner": {
        "id": "principal_01933b5a000070008000000000000001",
        "kind": "user"
      },
      "harness_id": "harness_01933b5a00007000800000000000001",
      "id": "app_01933b5a000070008000000000000001",
      "owner": {
        "id": "principal_01933b5a000070008000000000000001",
        "kind": "user"
      },
      "owner_principal_id": "principal_01933b5a000070008000000000000001",
      "status": "draft"
    }
  ]
}

500

Internal server error