API reference

GET/v1/posts/{id}

Get a post

Fetches one post, including per-account publish results.

Required permission: `posts:read`

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

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

Request

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

Path parameters

idstringrequired

Post 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.

Postrequired

Example

{
  "post": {
    "id": "a1b2c3d4-0000-4000-8000-000000000000",
    "status": "draft",
    "content": "Shipping today.",
    "contentType": "text",
    "media": [
      {
        "type": "image",
        "url": "https://cdn.example.com/media/launch.jpg"
      }
    ],
    "platforms": {},
    "scheduledAt": "string",
    "createdAt": "string",
    "updatedAt": "string",
    "completedAt": "string",
    "accounts": [
      {
        "id": "a1b2c3d4-0000-4000-8000-000000000000",
        "platformAccountId": "platformAccount_a1b2c3d4",
        "platform": "string",
        "name": "Acme Corp"
      }
    ],
    "results": [
      {
        "targetId": "target_a1b2c3d4",
        "platform": "facebook",
        "pageName": "Acme Corp",
        "status": "success",
        "result": null,
        "error": "string"
      }
    ],
    "completedTargets": 0,
    "failedTargets": 0,
    "totalTargets": 0
  }
}

Errors

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

StatusCodeWhen it happens
401invalid_api_keyThe key does not exist, was revoked, or is malformed. Keys start with cdyn_live_.
403profile_not_accessibleThe requested profile is outside this key’s scope, or belongs to another account.
404not_foundThe resource does not exist inside the resolved profile.
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.