List runs

curl --request GET \
  --url https://api.superglue.ai/v1/runs \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "runId": "7f3e9c1a-2b4d-4e8f-9a3b-1c5d7e9f2a4b",
      "toolId": "550e8400-e29b-41d4-a716-446655440000",
      "status": "success",
      "metadata": {
        "startedAt": "2023-11-07T05:31:56Z",
        "completedAt": "2023-11-07T05:31:56Z",
        "durationMs": 5234
      },
      "tool": {
        "id": "<string>",
        "version": "2.1.0"
      },
      "toolPayload": {},
      "data": {},
      "error": "Connection timeout after 30 seconds",
      "stepResults": [
        {
          "stepId": "<string>",
          "success": true,
          "data": {},
          "error": "<string>"
        }
      ],
      "options": {},
      "requestSource": "api",
      "traceId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
    }
  ],
  "page": 1,
  "limit": 50,
  "total": 327,
  "hasMore": true
}

GET

runs

List runs

curl --request GET \
  --url https://api.superglue.ai/v1/runs \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "runId": "7f3e9c1a-2b4d-4e8f-9a3b-1c5d7e9f2a4b",
      "toolId": "550e8400-e29b-41d4-a716-446655440000",
      "status": "success",
      "metadata": {
        "startedAt": "2023-11-07T05:31:56Z",
        "completedAt": "2023-11-07T05:31:56Z",
        "durationMs": 5234
      },
      "tool": {
        "id": "<string>",
        "version": "2.1.0"
      },
      "toolPayload": {},
      "data": {},
      "error": "Connection timeout after 30 seconds",
      "stepResults": [
        {
          "stepId": "<string>",
          "success": true,
          "data": {},
          "error": "<string>"
        }
      ],
      "options": {},
      "requestSource": "api",
      "traceId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
    }
  ],
  "page": 1,
  "limit": 50,
  "total": 327,
  "hasMore": true
}

Authorizations

Authorization

string

header

required

Static API key authentication using Bearer token scheme. Include your API key in the Authorization header: Authorization: Bearer YOUR_API_KEY

API keys can be generated in your superglue dashboard.

Query Parameters

toolId

string

status

enum<string>

Available options:

running,

success,

failed,

aborted

page

integer

default:1

limit

integer

default:50

Required range: x <= 100

Response

200 - application/json

List of runs

data

object[]

Show child attributes

data.runId

string

required

Unique identifier for this run (maps to 'id' in GraphQL schema)

Example:

"7f3e9c1a-2b4d-4e8f-9a3b-1c5d7e9f2a4b"

data.toolId

string

required

ID of the tool that was executed

Example:

"550e8400-e29b-41d4-a716-446655440000"

data.status

enum<string>

required

Execution status:

running: Execution in progress
success: Completed successfully
failed: Failed due to error
aborted: Cancelled by user or system

Available options:

running,

success,

failed,

aborted

Example:

"success"

data.metadata

object

required

Show child attributes

data.metadata.startedAt

string<date-time>

data.metadata.completedAt

string<date-time>

Only present when run has finished (success, failed, or aborted)

data.metadata.durationMs

integer

Example:

5234

data.tool

object

Tool metadata (not full configuration, maps to 'toolConfig' in GraphQL)

Show child attributes

data.tool.id

string

required

data.tool.version

string

Example:

"2.1.0"

data.toolPayload

object

The inputs and options provided when running the tool (maps to 'toolPayload' in GraphQL)

data.data

object

Tool execution results (only present when status is success, maps to 'toolResult' in GraphQL)

data.error

string

Error message (only present when status is failed or aborted)

Example:

"Connection timeout after 30 seconds"

data.stepResults

object[]

Results from each execution step (only for multi-step tools)

Show child attributes

data.stepResults.stepId

string

required

ID of the step that was executed

data.stepResults.success

boolean

required

Whether the step completed successfully

data.stepResults.data

object

Step execution result data

data.stepResults.error

string

Error message if step failed

data.options

object

Execution options that were used for this run

data.requestSource

string

Source identifier for where the run was initiated

Example:

"api"

data.traceId

string

Trace ID for this run (for debugging and log correlation)

Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

page

integer

Example:

1

limit

integer

Example:

50

total

integer

Example:

327

hasMore

boolean

Example:

true

Cancel a run

⌘I

Getting Started

Guides

SDK Reference

API Reference

List runs

Authorizations

Query Parameters

Response