Skip to main content
GET
/
runs
/
{run_uid}
/
inputs
Get inputs by Run UUID
curl --request GET \
  --url https://api.edges.run/v1/runs/{run_uid}/inputs \
  --header 'X-API-Key: <api-key>'
[
  {
    "uid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "input_data": {},
    "custom_data": {},
    "last_error": {
      "has_failed": true,
      "message": "<string>",
      "label": "<string>",
      "error_ref": "<string>",
      "params": {},
      "validation_errors": {}
    },
    "last_info": {
      "has_failed": true,
      "message": "<string>",
      "label": "<string>",
      "error_ref": "<string>",
      "params": {},
      "validation_errors": {}
    },
    "output_count": 123,
    "retry_count": 123,
    "started_at": "<string>",
    "finished_at": "<string>",
    "created_at": "<string>",
    "updated_at": "<string>"
  }
]
uid is used for all the endpoints and Run manipulation.The id is an internal identifier returned to smooth and improve speed and accuracy if you have questions about your runs you will want to submit to the team.

​
Overview

The GET /runs/{run_uid}/inputs endpoint returns the complete list of inputs associated with a run, including their execution status and any associated errors. This endpoint is essential for recovering detailed input-level results and errors, especially when webhook callbacks are missed or need to be verified.

​
Pagination

This endpoint uses cursor-based pagination by default. Follow the X-Pagination-Next response header to retrieve subsequent pages.
  • limit controls the page size (default: 100, max: 500).
  • The X-Pagination-Next header contains the full URL for the next page, including limit and cursor.
  • When the X-Pagination-Next header is absent, there are no more pages.
The offset parameter is deprecated. If provided, the system falls back to offset-based pagination and cursor pagination is not used. Prefer following the X-Pagination-Next URL for all new integrations.

Authorizations

​
X-API-Key
string
header
required

Path Parameters

​
run_uid
string<uuid>
required

Run UUID

Query Parameters

​
limit
integer
default:100

Number of inputs to return

Required range: 1 <= x <= 500
​
offset
integer | null
deprecated

(deprecated) Number of inputs to skip for pagination

Required range: x >= 0
​
cursor
string

(optional) Cursor value obtained from the X-Pagination-Next response header of a previous request, used to continue pagination. If not provided, the first page will be returned.

Response

Returns the run inputs

​
uid
string<uuid>

Unique identifier for the input.

​
status
enum<string> | null

Current status of the input.

Available options:
CREATED,
QUEUED,
SCHEDULED,
RUNNING,
BLOCKED,
FAILED,
SUCCEEDED,
STOPPED
​
input_data
object

Input payload.

​
custom_data
object

Custom metadata or additional information.

​
last_error
object

Information about the last execution attempt.

​
last_info
object

Information about the last execution attempt.

​
output_count
integer

Number of outputs generated by the input.

​
retry_count
integer | null

Number of retry attempts for the input.

​
started_at
string | null

Timestamp when the input started.

​
finished_at
string | null

Timestamp when the input finished.

​
created_at
string

Timestamp when the input was created.

​
updated_at
string | null

Timestamp when the input was last updated.