API reference

GET/v1/profiles

List profiles

Returns every profile this API key can act on. A profile is one customer of your platform: it owns its own connected accounts, posts, and policy.

Required permission: `connections:read`

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

Request

curl -X GET "https://api.cutedyno.com/v1/profiles" \
  -H "Authorization: Bearer $CUTEDYNO_API_KEY"

This endpoint takes no parameters.

Response

Returns 200 with the following body.

Profile[]required
totalnumberrequired

Example

{
  "profiles": [
    {
      "id": "a1b2c3d4-0000-4000-8000-000000000000",
      "name": "Acme Corp",
      "description": "string",
      "createdAt": "string",
      "updatedAt": "string"
    }
  ],
  "total": 1
}

Errors

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

StatusCodeWhen it happens
401authentication_requiredNo Authorization header was sent, or it was not a Bearer token.
401invalid_api_keyThe key does not exist, was revoked, or is malformed. Keys start with cdyn_live_.
403insufficient_permissionThe key is missing the scope this endpoint needs, for example posts:write on a readonly key.
429rate_limit_exceededToo many requests for this key. Honour the Retry-After header before retrying.
500internal_errorSomething failed on our side. Retry with the same Idempotency-Key; report the requestId if it persists.