Get app by ID

GET

/v1/apps/{app_id}

const url = 'https://app.everruns.com/api/v1/apps/example';
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/example

Parameters

Path Parameters

app_id

required

string

App ID

Responses

200

App found

application/json

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

{
  "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"
}

400

Invalid app ID

404

App not found

500

Internal server error