API reference

POST/v1/posts/{id}/retry

Retry a failed post

Requeues a failed or partially published post. Only the accounts that failed are retried.

Required permission: `posts:write`

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

Base URL
https://api.cutedyno.com
Permission
posts:write
Idempotency
Send an Idempotency-Key header so a retry cannot apply twice. How it works
MCP tool
retry_post

Request

curl -X POST "https://api.cutedyno.com/v1/posts/POST_ID/retry" \
  -H "Authorization: Bearer $CUTEDYNO_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"

Path parameters

idstringrequired

Post id.

Headers

Idempotency-Keystringoptional

A unique key so a retried request is not applied twice. Stored for 24 hours.

Response

Returns 200 with the following body.

objectrequired

Example

{
  "post": {
    "id": "a1b2c3d4-0000-4000-8000-000000000000",
    "status": "draft"
  }
}

Errors

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

StatusCodeWhen it happens
400invalid_state_transitionThe post is in a state that does not allow this operation, for example editing a post that already published.
401invalid_api_keyThe key does not exist, was revoked, or is malformed. Keys start with cdyn_live_.
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.