Get a connect session

Polls a connect session. Once status is completed, the accounts array lists what was connected.

Required permission: `connections:read`

Accepts `profileId` to target a specific profile. Omit it to use the key’s home profile.

Base URL: https://api.cutedyno.com
Permission: connections:read
Idempotency: Not applicable. This request has no side effects worth deduplicating.
MCP tool: get_connect_session

Request

curl -X GET "https://api.cutedyno.com/v1/connect/sessions/SESSION_ID?profileId=PROFILE_ID" \
  -H "Authorization: Bearer $CUTEDYNO_API_KEY"

Path parameters

idstringrequired

Connect session id.

Query parameters

profileIdstringoptional

Profile to act on. Defaults to the profile the API key was created in.

Response

Returns 200 with the following body.

ConnectSessionrequired

Account[]required

Example

{
  "session": {
    "id": "a1b2c3d4-0000-4000-8000-000000000000",
    "platform": "facebook",
    "status": "pending",
    "authUrl": "https://cdn.example.com/media/launch.jpg",
    "url": "https://cdn.example.com/media/launch.jpg",
    "errorMessage": "Shipping today.",
    "createdAt": "string",
    "completedAt": "string",
    "expiresAt": "string"
  },
  "accounts": [
    {
      "id": "a1b2c3d4-0000-4000-8000-000000000000",
      "platformAccountId": "platformAccount_a1b2c3d4",
      "accountId": "account_a1b2c3d4",
      "platform": "facebook",
      "name": "Acme Corp",
      "username": "Acme Corp",
      "profilePictureUrl": "https://cdn.example.com/media/launch.jpg",
      "connectedAt": "string"
    }
  ]
}

Errors

Failures use the standard error envelope. Branch on code, never on the message.

Status	Code	When it happens
401	invalid_api_key	The key does not exist, was revoked, or is malformed. Keys start with cdyn_live_.
403	profile_not_accessible	The requested profile is outside this key’s scope, or belongs to another account.
404	not_found	The resource does not exist inside the resolved profile.
429	rate_limit_exceeded	Too many requests for this key. Honour the Retry-After header before retrying.
500	internal_error	Something failed on our side. Retry with the same Idempotency-Key; report the requestId if it persists.