Skip to content
Sign in Waitlist
Docs/API reference/Posts/Resend to the inbox

Resend to the inbox

POST /v1/posts/:id/items/:item/resend scope write

Sends a TikTok draft item that was already sent to the inbox and not yet posted in the app to the inbox again: a new notification for the same video. Returns the post; the send runs in the background (resend.inProgress).

HeadersAuthorization: Bearer praeko_… and X-Praeko-Contract: en. Always send both.

Parameters

Name In Description
id path Post id.
item path Id of the post item (the items[].id field of the GET /v1/posts/:id response).
Idempotency-Key header Idempotency key (1 to 255 visible characters, for example a UUID). Repeating the SAME request with the same key within 24 h returns the stored response (with Idempotent-Replayed: true) without running it again; a different request with the same key returns 422 idempotency_key_reuse; a request still in progress returns 409 idempotency_in_progress. 5xx errors are not stored. The key is scoped per workspace and per route. See Retry a request safely.

Example

curl -X POST "https://praeko.app/v1/posts/01KA3W2Y6H1RC5ZQ8M0T4VXE7N/items/01KA3W2Y6J9D3BNF7G2K5PQS8A/resend" \
  -H "Authorization: Bearer $PRAEKO_KEY" \
  -H "X-Praeko-Contract: en"

Response

Success status When
200 Success.
Response 200
{
  "id": "01KA3W2Y6H1RC5ZQ8M0T4VXE7N",
  "title": "The test that only failed on Mondays (final cut)",
  "state": "queued",
  "type": "short",
  "kind": "video",
  "origin": "api",
  "media": {
    "video": "01KA3VQ7M2T9XE4HB8N5RZ6C0D",
    "cover": null
  },
  "texts": {
    "youtube": {
      "title": "The test that only failed on Mondays",
      "text": "A test that passed from Tuesday to Sunday. What it was hiding.\n\n#programming #testing"
    }
  },
  "tags": [
    "behind-the-scenes",
    "testing"
  ],
  "thumb": null,
  "items": [
    {
      "id": "01KA3W2Y6J9D3BNF7G2K5PQS8A",
      "network": "tiktok",
      "channel": "01KA3V0R5D8M2WQ7X4HT9NZ1BF",
      "state": "draft",
      "scheduledFor": "2026-11-09T17:00:00.000Z",
      "custom": true,
      "mode": "draft",
      "inInbox": true,
      "delivery": {
        "publishId": "v_inbox_file~v2.7501234567890123456",
        "status": "SEND_TO_USER_INBOX",
        "checkedAt": "2026-11-07T14:02:11.482Z"
      },
      "deliveries": [
        {
          "number": 1,
          "publishId": "v_inbox_file~v2.7501234567890123455",
          "status": "SEND_TO_USER_INBOX",
          "sentAt": "2026-11-09T17:00:41.000Z"
        },
        {
          "number": 2,
          "publishId": "v_inbox_file~v2.7501234567890123456",
          "status": "SEND_TO_USER_INBOX",
          "sentAt": "2026-11-07T14:02:11.482Z"
        }
      ],
      "resend": {
        "allowed": true,
        "remaining": 2,
        "inProgress": false
      },
      "warning": "The video was sent to the TikTok inbox (account Dev Ocioso): in the app, open the Inbox and tap this video's notification."
    }
  ],
  "createdAt": "2026-11-07T14:02:11.482Z",
  "updatedAt": "2026-11-07T15:40:03.120Z",
  "actions": []
}

Returns the whole post. The new send runs in the background: right after the request the item has resend.inProgress: true; when it finishes, deliveries gains an entry (number 2, 3…) and delivery shows the last one. If TikTok refuses, the item stays as it was and resend.error carries code (tiktok_pending_limit for the limit of 5 pending sends in 24 h, or tiktok_error) and message. items[].warning and items[].resend.error.message are free text the server writes in Portuguese; the example shows it in English.

Example read from the codeThis route cannot be called in our tests without a real provider (Meta, a video on YouTube, TikTok…), so the example was written by reading the server code. The other responses come from real calls to the test server.

Errors

Status code When
404 post_not_found The post does not exist.
404 item_not_found The item does not belong to this post.
422 not_resendable The item is not a TikTok draft already sent to the inbox.
409 already_posted The video was already posted in the TikTok app.
409 resend_in_progress A resend is already running for this item (one stuck for more than 30 minutes stops blocking).
429 resend_limit_reached More than 3 resends of this item in the last 24 h (details.availableAt says when it frees up).
409 channel_not_connected The TikTok account of this item is not connected (revoked or disconnected).
422 idempotency_key_reuse The Idempotency-Key was already used with a different request (different method, path, query or body).
409 idempotency_in_progress A request with the same Idempotency-Key is still in progress (retry in a moment).
409 idempotency_response_too_large The original response was larger than 256 KB and was not stored; fetch the resource with GET instead.

Errors on any route

Status code When
401 unauthorized The Authorization: Bearer … header is missing.
401 invalid_api_key The key does not exist.
401 revoked_api_key The key has been revoked.
401 expired_api_key The key has expired.
403 forbidden The key's scope is not enough for this route (see the scope badge).
429 rate_limited The per-minute request limit was exceeded.

The body of every error is { "error": { "code", "message", "details"? } }. See all error codes.

Try it

Try it

The live test uses your key and your account. It stays off when you are not signed in.

Sign in to try it
Question or mistake on this page? contato@praeko.appView .md

Type to search pages, routes and error codes.