---
title: "List a run's connectors"
method: GET
path: "/v1/runs/{runId}/connectors"
tags: ["Connectors"]
---

# List a run's connectors

`GET /v1/runs/{runId}/connectors`

## Request

- Base URL: `https://api.ironfang.com/rig`
- URL: `https://api.ironfang.com/rig/v1/runs/{runId}/connectors`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Returns every connector minted for the run with its state (pending, online, offline), the routes it is bound to and when it was last seen, plus how many deliveries are still waiting for a connector. Neither credential is ever returned here. Read-only.

## Response `200`

The connectors

- object
  - `connectors` Connector[], required
    - `bootstrap_expires_at` string, date-time, required
    - `bootstrap_used_at` string, date-time
    - `client` object: What the connector said about itself at hello (version, os, arch).
    - `connected_at` string, date-time
    - `created_at` string, date-time, required
    - `created_by` string
    - `disconnected_at` string, date-time
    - `id` string, uuid, required
    - `last_seen_at` string, date-time
    - `name` string
    - `organisation_id` string, uuid, required
    - `routes` string[], required: The route labels the credential is bound to.
    - `run_id` string, uuid, required
    - `session_expires_at` string, date-time: Never later than the run's expiry.
    - `status` 'pending' | 'online' | 'offline', required
  - `online` integer, required: How many connectors hold a session now.
  - `pending_deliveries` integer, required: Callbacks queued for a route that no session has answered yet.

## Other responses

- `401`: No credential, an invalid one, or a delegated token where none is accepted (`unauthorized`, `invalid_api_key`, `delegated_not_allowed`).
- `403`: The credential lacks the permission or scope, or names another organisation (`forbidden`, `insufficient_scope`).
- `404`: No such object in this organisation (`not_found`).

---

[API](https://skmtc.dev/ironfang/apis/ironfang-rig-api.md) · [All operations](https://skmtc.dev/ironfang/apis/ironfang-rig-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ironfang/apis/ironfang-rig-api/revisions/3e86a312dad1?raw)