List the workspace's connections
connection:readReturns every connection in the caller's workspace, newest first (ordered by createdAt DESC). Connections are WORKSPACE-scoped, never org-scoped: a connection created in another workspace is invisible here and cannot be referenced by a workflow in this one.
The stored credential is NEVER returned. What you POSTed as config is encrypted at rest (envelope-encrypted under a per-org key) and the Go model tags it json:"-", so no field of any response — list, single read, create or update — ever contains it. There is no endpoint that reads a secret back. If you need the value later, keep it on your side.
List rows are a REDUCED projection: workspaceId and orgId appear in the JSON but are always the all-zero UUID 00000000-0000-0000-0000-000000000000, because the list query does not select those columns, and createdBy is absent. Read a single connection if you need the real tenancy ids.
Quirk: when the workspace has no connections the payload is {"data": null}, not {"data": []}. Treat null as an empty list.
Authorization
bearerAuth An API token: Authorization: Bearer grt_…. Mint one in the app under Settings → Workspace → API tokens; the raw value is shown once. Scopes confine the token — see x-permission on each operation.
In: header
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/api/connections"{ "data": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "pieceId": "string", "name": "string", "authType": "string", "status": "active", "lastTestedAt": "2019-08-24T14:15:22Z", "tokenExpiresAt": "2019-08-24T14:15:22Z", "workspaceId": "ef0efa32-d1c1-43d4-a5e2-fe7b4f00403c", "orgId": "25b2c2d5-a7fc-47d0-89e4-8709a1560bfa", "createdBy": "25a02396-1048-48f9-bf93-102d2fb7895e", "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z" } ]}