API referenceProvider accounts
Every connected account, with the kept sign-ins and Domain Connect grants
The workspace's provider accounts with their access mode, the domains they cover, when they were last used and when they expire, and whether the caller may manage each one (can_manage); and, in kept_access, the sign-ins and Domain Connect authorizations kept per domain, grouped by provider. A kept sign-in is stopped per domain with DELETE /connections/{id}/grant.
Authorization
apiKey AuthorizationBearer <token>
Long-lived tenant API key, cd_live_… (production) or cd_test_… (staging, development), stored hashed. Keys created before the switch to cd_ start with sk_live_… / sk_test_… and are still accepted. Scoped to the owning application's tenant.
In: header
Response Body
application/json
application/json
curl -X GET "https://example.com/provider-accounts"{ "accounts": [ { "id": "string", "kind": "api_key", "provider": "string", "provider_name": "string", "label": "string", "access": "continuous", "scope": "all", "domains": [ "string" ], "credential_held": true, "status": "active", "last_error": "string", "created_by": "string", "last_used_at": "2019-08-24T14:15:22Z", "expires_at": "2019-08-24T14:15:22Z", "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z", "connections": [ { "id": "string", "application_id": "string", "domain": "string", "status": "string" } ], "uses": [ "string" ], "can_manage": true } ], "kept_access": [ { "kind": "sign_in", "provider": "string", "provider_name": "string", "access": "continuous", "connections": [ { "id": "string", "application_id": "string", "domain": "string", "status": "string" } ], "created_at": "2019-08-24T14:15:22Z", "last_used_at": "2019-08-24T14:15:22Z", "uses": [ "string" ] } ], "keeping_available": true}{ "code": "string", "title": "string", "details": "string"}