Skip to content
Everruns Everruns

Recent app invocation runs

GET
/v1/apps/{app_id}/runs
 
curl --request GET \
  --url https://app.everruns.com/api/v1/apps/example/runs

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
app_id
required
string

App ID

Query Parameters

Section titled “Query Parameters ”
window
string | null

Time window to include, such as 24h, 60m, or 7d.

groupBy
string | null

Optional grouping. Currently only hour is supported.

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Recent app invocation runs

Media type application/json

Paged response for the app run history endpoint, optionally including a per-hour histogram.

object
buckets

Per-hour aggregate buckets when the caller asked for them.

Array<object> | null

One bucket of the run-history histogram (per-hour aggregate).

object
err
required

Count of runs that failed in this bucket.

integer format: int32
hour
required

Bucket start (top of the hour, RFC 3339).

string format: date-time
ok
required

Count of runs that completed successfully in this bucket.

integer format: int32
running

Count of runs still running when the bucket was queried.

integer | null format: int32
data
required

Page of run events ordered newest first.

Array<object>

Single app-channel invocation record (one run = one channel-side event).

object
app_id
required

App that received the invocation.

string
channel_id
required

Channel that originated the invocation.

string
channel_name

Human-readable channel name when set.

string | null
channel_type
required

Channel kind (slack, ag_ui, webhook, a2a, fcp).

string
Allowed values: slack ag_ui schedule webhook a2a fcp
completed_at

Timestamp the run finished, if any (RFC 3339).

string | null format: date-time
created_at
required

Timestamp the run started (RFC 3339).

string format: date-time
id
required

Prefixed public identifier of this run event.

string
status
required

Terminal status (ok, err, running).

string
Example 
{
  "data": [
    {
      "channel_type": "slack"
    }
  ]
}

400

Section titled “400 ”

Invalid app ID or query

Media type application/json

Standard error response.

Wire shape is RFC 9457 Problem Details: every error response includes title and status, and may include detail, code, allowed_actions, retry_after_seconds, instance, and type. The content type is rewritten to application/problem+json by [problem_json_content_type].

object
allowed_actions

Recovery actions the caller can take next.

Array<object>

Agent-actionable recovery hint attached to an error response.

object
hint

Short, agent-readable hint (e.g. “Shorten ‘name’ to <= 200 chars.”).

string | null
href

Optional absolute or relative URL the caller may invoke directly.

string | null
operation_id

OpenAPI operationId the caller should invoke to recover.

string | null
rel
required

Link relation describing the action (e.g. retry, get-existing, unarchive, retry-later).

string
code

Stable, machine-readable error code (snake_case).

string | null
detail

Human-readable explanation specific to this occurrence.

string | null
instance

Request URI for this occurrence.

string | null
retry_after_seconds

Seconds the caller should wait before retrying (429 / transient 503).

integer | null format: int32
status
required

HTTP status code; mirrors the response status line.

integer format: int32
title
required

Short, human-readable summary of the problem (e.g. “Not Found”).

string
type

RFC 9457 problem type URI. Optional; identifies the problem class.

string | null
Example generated
{
  "allowed_actions": [
    {
      "hint": "example",
      "href": "example",
      "operation_id": "example",
      "rel": "example"
    }
  ],
  "code": "example",
  "detail": "example",
  "instance": "example",
  "retry_after_seconds": 1,
  "status": 1,
  "title": "example",
  "type": "example"
}

401

Section titled “401 ”

Unauthorized

Media type application/json

Standard error response.

Wire shape is RFC 9457 Problem Details: every error response includes title and status, and may include detail, code, allowed_actions, retry_after_seconds, instance, and type. The content type is rewritten to application/problem+json by [problem_json_content_type].

object
allowed_actions

Recovery actions the caller can take next.

Array<object>

Agent-actionable recovery hint attached to an error response.

object
hint

Short, agent-readable hint (e.g. “Shorten ‘name’ to <= 200 chars.”).

string | null
href

Optional absolute or relative URL the caller may invoke directly.

string | null
operation_id

OpenAPI operationId the caller should invoke to recover.

string | null
rel
required

Link relation describing the action (e.g. retry, get-existing, unarchive, retry-later).

string
code

Stable, machine-readable error code (snake_case).

string | null
detail

Human-readable explanation specific to this occurrence.

string | null
instance

Request URI for this occurrence.

string | null
retry_after_seconds

Seconds the caller should wait before retrying (429 / transient 503).

integer | null format: int32
status
required

HTTP status code; mirrors the response status line.

integer format: int32
title
required

Short, human-readable summary of the problem (e.g. “Not Found”).

string
type

RFC 9457 problem type URI. Optional; identifies the problem class.

string | null
Example generated
{
  "allowed_actions": [
    {
      "hint": "example",
      "href": "example",
      "operation_id": "example",
      "rel": "example"
    }
  ],
  "code": "example",
  "detail": "example",
  "instance": "example",
  "retry_after_seconds": 1,
  "status": 1,
  "title": "example",
  "type": "example"
}

403

Section titled “403 ”

Forbidden

Media type application/json

Standard error response.

Wire shape is RFC 9457 Problem Details: every error response includes title and status, and may include detail, code, allowed_actions, retry_after_seconds, instance, and type. The content type is rewritten to application/problem+json by [problem_json_content_type].

object
allowed_actions

Recovery actions the caller can take next.

Array<object>

Agent-actionable recovery hint attached to an error response.

object
hint

Short, agent-readable hint (e.g. “Shorten ‘name’ to <= 200 chars.”).

string | null
href

Optional absolute or relative URL the caller may invoke directly.

string | null
operation_id

OpenAPI operationId the caller should invoke to recover.

string | null
rel
required

Link relation describing the action (e.g. retry, get-existing, unarchive, retry-later).

string
code

Stable, machine-readable error code (snake_case).

string | null
detail

Human-readable explanation specific to this occurrence.

string | null
instance

Request URI for this occurrence.

string | null
retry_after_seconds

Seconds the caller should wait before retrying (429 / transient 503).

integer | null format: int32
status
required

HTTP status code; mirrors the response status line.

integer format: int32
title
required

Short, human-readable summary of the problem (e.g. “Not Found”).

string
type

RFC 9457 problem type URI. Optional; identifies the problem class.

string | null
Example generated
{
  "allowed_actions": [
    {
      "hint": "example",
      "href": "example",
      "operation_id": "example",
      "rel": "example"
    }
  ],
  "code": "example",
  "detail": "example",
  "instance": "example",
  "retry_after_seconds": 1,
  "status": 1,
  "title": "example",
  "type": "example"
}

404

Section titled “404 ”

App not found

Media type application/json

Standard error response.

Wire shape is RFC 9457 Problem Details: every error response includes title and status, and may include detail, code, allowed_actions, retry_after_seconds, instance, and type. The content type is rewritten to application/problem+json by [problem_json_content_type].

object
allowed_actions

Recovery actions the caller can take next.

Array<object>

Agent-actionable recovery hint attached to an error response.

object
hint

Short, agent-readable hint (e.g. “Shorten ‘name’ to <= 200 chars.”).

string | null
href

Optional absolute or relative URL the caller may invoke directly.

string | null
operation_id

OpenAPI operationId the caller should invoke to recover.

string | null
rel
required

Link relation describing the action (e.g. retry, get-existing, unarchive, retry-later).

string
code

Stable, machine-readable error code (snake_case).

string | null
detail

Human-readable explanation specific to this occurrence.

string | null
instance

Request URI for this occurrence.

string | null
retry_after_seconds

Seconds the caller should wait before retrying (429 / transient 503).

integer | null format: int32
status
required

HTTP status code; mirrors the response status line.

integer format: int32
title
required

Short, human-readable summary of the problem (e.g. “Not Found”).

string
type

RFC 9457 problem type URI. Optional; identifies the problem class.

string | null
Example generated
{
  "allowed_actions": [
    {
      "hint": "example",
      "href": "example",
      "operation_id": "example",
      "rel": "example"
    }
  ],
  "code": "example",
  "detail": "example",
  "instance": "example",
  "retry_after_seconds": 1,
  "status": 1,
  "title": "example",
  "type": "example"
}

500

Section titled “500 ”

Internal server error

Media type application/json

Standard error response.

Wire shape is RFC 9457 Problem Details: every error response includes title and status, and may include detail, code, allowed_actions, retry_after_seconds, instance, and type. The content type is rewritten to application/problem+json by [problem_json_content_type].

object
allowed_actions

Recovery actions the caller can take next.

Array<object>

Agent-actionable recovery hint attached to an error response.

object
hint

Short, agent-readable hint (e.g. “Shorten ‘name’ to <= 200 chars.”).

string | null
href

Optional absolute or relative URL the caller may invoke directly.

string | null
operation_id

OpenAPI operationId the caller should invoke to recover.

string | null
rel
required

Link relation describing the action (e.g. retry, get-existing, unarchive, retry-later).

string
code

Stable, machine-readable error code (snake_case).

string | null
detail

Human-readable explanation specific to this occurrence.

string | null
instance

Request URI for this occurrence.

string | null
retry_after_seconds

Seconds the caller should wait before retrying (429 / transient 503).

integer | null format: int32
status
required

HTTP status code; mirrors the response status line.

integer format: int32
title
required

Short, human-readable summary of the problem (e.g. “Not Found”).

string
type

RFC 9457 problem type URI. Optional; identifies the problem class.

string | null
Example generated
{
  "allowed_actions": [
    {
      "hint": "example",
      "href": "example",
      "operation_id": "example",
      "rel": "example"
    }
  ],
  "code": "example",
  "detail": "example",
  "instance": "example",
  "retry_after_seconds": 1,
  "status": 1,
  "title": "example",
  "type": "example"
}