List connections

GET

/api/connections

Maintainer:Not configured

OperationId:list_connections

Lists the connections the caller may manage, newest first. A system admin sees every connection; any other caller sees only those owned by a team they own. Revoked connections are omitted unless include_revoked is set.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Query Params

Header Params

Responses

🟢200OK

application/json

The connections visible to the caller

Bodyapplication/json

🟠401Unauthorized

🟠403Forbidden

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api/connections?include_revoked=undefined' \
--header 'X-Temper-Surface;' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

[
    {
        "created": "2019-08-24T14:15:22.123Z",
        "credential": null,
        "emitter_entity_id": "74f9ef22-56cd-44a1-b6f4-d3420fa912a3",
        "home_context_id": "6e15eaf0-2480-45bb-aace-bbc431db5ff7",
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "name": "string",
        "observed_reach": null,
        "owner_team_id": "5f2e83f0-a87c-4d3f-b3e5-3bbc66dabe7e",
        "profile_id": "bfcb6779-b1f9-41fc-92d7-88f8bc1d12e8",
        "provider": "string",
        "reach_affirmation": "string",
        "reach_affirmed_at": "2019-08-24T14:15:22.123Z",
        "reach_affirmed_by": "fe90f864-e284-4f18-8ddc-222f4152b26f",
        "reach_covers": "string",
        "reach_granularity": "string",
        "registered_by_profile_id": "18e6908a-ccb7-48bf-a180-a379e0568e01",
        "revoked_at": "2019-08-24T14:15:22.123Z",
        "revoked_by_profile_id": "e2512452-9e5c-40a6-8117-21bb43a829e4",
        "slug": "string",
        "tool_manifest": null,
        "webhook_events": [
            "string"
        ]
    }
]

Modified at 2026-10-06 12:32:37

Get a single shape by ID.

Provision a connection