Repostly

将短视频定时发布到 TikTok、Instagram、YouTube、Facebook 和 Threads,并查看帖子分析数据。

托管 MCP 服务器

npx add-mcp 'https://server.repostly.app/mcp'

可安装到 Claude Code、Codex、Cursor 等客户端

文档

Build on Repostly

Everything you schedule in the Repostly app, available from your own code, automations and AI agents. One JSON API, one key, the same rules as the app.

https://api.repostly.app/v1

  • Schedule posts

    Publish one post to TikTok, YouTube, Instagram, Facebook and Threads, now or at a set time.
  • Upload media

    Send a video or images once. Reuse the asset ID in as many posts as you like.
  • Automate reposting

    Create workflows that repost new or older content from one account to another.
  • Read analytics

    Views, likes, comments and followers, per post or across your accounts.

Made for automations and AI agents

Predictable JSON, stable post IDs, idempotent writes and scoped keys make the API safe to call from Zapier-style tools and LLM agents. Connect an AI assistant such as Claude or ChatGPT through the MCP server with OAuth, no key needed: see Connect an AI assistant. Manage permissions in AI assistants. The same publishing rules and plan limits apply.

Connecting social accounts, billing and API keys stay in the Repostly app. Prefer a machine-readable contract? Download the OpenAPI document.

  1. Create an API key

    In the app, open API keys from the profile menu, pick the scopes you need and copy the key. It is shown once. ShellCopy
    export REPOSTLY_API_KEY='rp_live_…'
    
  2. Check the key

    GET /me confirms your plan, the key's scopes and your rate limits. ShellCopy
    curl https://api.repostly.app/v1/me \
      -H "Authorization: Bearer $REPOSTLY_API_KEY"
    
    Response (abridged)Copy
    {
      "plan": "pro",
      "key": { "name": "Zapier", "scopes": ["accounts:read", "assets:write", "posts:write"] },
      "rateLimits": { "windowSeconds": 60, "total": 300, "writes": 60 }
    }
    
  3. Pick a destination

    Each connected social account has an ID. Connect accounts in the app first. A key with accounts:write can also disconnect one with DELETE /accounts/{id}, which removes the account's workflows and stored data too. ShellCopy
    curl https://api.repostly.app/v1/accounts \
      -H "Authorization: Bearer $REPOSTLY_API_KEY"
    # → { "data": [{ "id": "6650f1c2a4b3c2d1e0f98765", "platform": "instagram", ... }] }
    
  4. Upload a video

    Send the file as multipart field file (up to 100 MiB). The kind (video or image) is detected for you. For larger videos (up to 500 MiB), use a direct upload: create an upload, PUT the file to its URL, then complete it. ShellCopy
    curl -X POST https://api.repostly.app/v1/assets \
      -H "Authorization: Bearer $REPOSTLY_API_KEY" \
      -F 'file=@launch.mp4'
    # → { "id": "6650f1c2a4b3c2d1e0f98766", "kind": "video", ... }
    
  5. Create the post

    Leave out scheduledAt to publish on the next scheduler run. The placement defaults per platform (Instagram → Reels). ShellCopy
    curl -X POST https://api.repostly.app/v1/posts \
      -H "Authorization: Bearer $REPOSTLY_API_KEY" \
      -H 'Idempotency-Key: launch-post-0001' \
      -H 'Content-Type: application/json' \
      -d '{
        "caption": "Launch day!",
        "scheduledAt": "2027-06-01T09:00:00+02:00",
        "videoAssetId": "6650f1c2a4b3c2d1e0f98766",
        "destinations": [{ "accountId": "6650f1c2a4b3c2d1e0f98765" }]
      }'
    
  6. Track it

    Poll the post. Each destination reports its own status and, once live, its URL. ShellCopy
    curl https://api.repostly.app/v1/posts/6650f1c2a4b3c2d1e0f98767 \
      -H "Authorization: Bearer $REPOSTLY_API_KEY"
    # → { "status": "scheduled", "destinations": [{ "status": "scheduled", "url": null, ... }] }
    

[!accent] Accent Paid plans only

The API is part of the Starter, Pro and Expert plans. Without a plan, every request except GET /me returns 403 PLAN_REQUIRED.

Repostly runs a remote Model Context Protocol (MCP) server. It uses Streamable HTTP and OAuth, and exposes the operations of this API as tools. You sign in to Repostly and decide which permissions the assistant gets. A paid plan is required for everything except reading the account.

https://server.repostly.app/mcp

Set up your client

  • Claude (claude.ai and Claude Desktop). Open Settings → Connectors → Add custom connector, paste the server URL and choose Connect. Sign in to Repostly and choose the permissions. On Claude Team and Enterprise, an owner may need to add the connector in admin settings first.
  • ChatGPT. Add a custom connector (app) with the server URL in the connectors settings; this may need developer mode. Then choose Connect and sign in to Repostly. Menu names vary by plan and version.
  • Claude Code. Add the server, then authenticate from inside Claude Code.

Claude Code

claude mcp add --transport http repostly https://server.repostly.app/mcp
# then run /mcp inside Claude Code and choose Authenticate

Other clients (Cursor, VS Code and more) need support for remote MCP with OAuth. Add the server URL in the client’s MCP settings; the exact file differs per client, two common shapes are:

Cursor-style configuration

{
  "mcpServers": {
    "repostly": { "url": "https://server.repostly.app/mcp" }
  }
}

VS Code (.vscode/mcp.json)

{
  "servers": {
    "repostly": { "type": "http", "url": "https://server.repostly.app/mcp" }
  }
}

The client registers itself with Repostly, so there is nothing to copy from the app. When you connect, your browser opens a Repostly consent screen showing the client name and the requested permissions.

Permissions

The permissions are the API scopes. The consent screen groups them per area (View, Publish, Manage, Upload, Disconnect) and every permission the assistant requests starts checked; untick what you do not want, or use Clear all. Disconnecting accounts permanently removes that account's workflows and stored data in Repostly, so untick it unless you need it.

PermissionWhat it allows
accounts:readView connected social accounts and publishing options
accounts:writeDisconnect connected social accounts
posts:readView posts, schedules and publishing status
posts:writeCreate, publish, edit and cancel posts
workflows:readView reposting workflows and their activity
workflows:writeCreate, change, pause and delete reposting workflows
assets:readView uploaded media
assets:writeUpload media and manage pending uploads
analytics:readRead performance analytics
  • Reconnecting the same assistant replaces its previous connection with the permissions you approve this time.
  • To add a permission later, reconnect: the assistant asks again and you approve it in the browser. A connection never gains permissions silently.
  • A connection lasts up to 90 days, then you connect again.
  • See and revoke connections under Account → AI assistants. Revoking ends the connection; posts already scheduled stay scheduled.

What it can do

34 tools, named like the operations in the reference. Each needs the scope shown on its operation.

AreaToolsUse
Account & capabilitiesgetMe getPublishingCapabilitiesPlan, approved permissions, expiry and rate limits; supported content kinds, placements and workflow types.
AccountslistAccounts getAccount getTiktokCreatorInfo disconnectAccountFind connected accounts, read TikTok creator options, disconnect an account (needs accounts:write).
Media & uploadslistAssets getAsset createUpload completeUpload getUpload cancelUploadReuse library media or upload a new file with the direct-upload flow.
PostslistPosts getPost createPost replacePost cancelPost getPostAnalyticsSchedule one post to several accounts, check each destination, edit or cancel pending posts.
Late postslistLatePosts resolveLatePostsFind posts paused past their time; publish, reschedule or discard selected ones.
WorkflowslistWorkflows getWorkflow createWorkflow replaceWorkflow deleteWorkflow pauseWorkflow resumeWorkflow getWorkflowActivity retryWorkflowPreparation retryWorkflowPostManage repost automations, inspect blocked and failed items, retry them.
AnalyticsgetAnalyticsSummary getAnalyticsTimeseries getTopPosts getBestPostingTimesTotals, trends, top posts and audience activity from stored observations.

Things you can ask:

  • “Schedule this video to my Instagram and TikTok tomorrow at 9am.”
  • “Which of my workflows have failed posts? Retry them.”
  • “Show my top posts this week.”
  • “Which posts are paused because they missed their time? Reschedule them for Friday.”
  • “When is the best time to post for my YouTube account?”
  • “Disconnect my old Facebook page.”

Multipart POST /assets is not a tool; assistants use the direct-upload tools or media already in your library.

Uploading media

  • Assistants with file access (Claude Code, Claude Desktop with a shell, Codex, Cursor). They call createUpload, send the file with PUT to upload.url using exactly upload.headers (for example curl -T FILE), then call completeUpload and poll getUpload until it is ready. The OAuth token is never sent to the storage URL.
  • Hosted chat apps without file access (claude.ai on the web, ChatGPT). They cannot upload your files. Upload the media in the Repostly app, then ask the assistant to use it from your library (listAssets).

What an assistant with a shell runs

# createUpload returns upload.url and upload.headers
curl -T launch.mp4 \
  -H "Content-Type: video/mp4" \
  -H "Content-Length: 48211902" \
  "<upload.url>"
# then completeUpload and poll getUpload until status is "ready"

Safety and limits

  • Check before it acts. Assistants are instructed to confirm content, accounts and time before publishing or doing anything destructive. A post created without scheduledAt publishes on the next scheduler run; it is not a draft. Keep write permissions off if you only want to read.
  • Retries are safe. Tools that create or change things take an idempotencyKey, so a repeated call does not publish twice. See Idempotency & retries.
  • Same rules as the API. The same plan, scopes, rate limits and error codes apply. Disconnecting an account also deletes its workflows and stored data; the platform authorization is not revoked.

Troubleshooting

SymptomWhat to do
Sign-in loops or the assistant says it is not connectedRevoke the connection under AI assistants in the app, remove the connector in the assistant and connect again.
INSUFFICIENT_SCOPE, or a tool is refusedThe connection lacks that permission. Reconnect and approve it (for example posts:write), then ask again.
PLAN_REQUIREDEverything except reading the account needs an active Starter, Pro or Expert plan.
429 or rate limitWait for Retry-After seconds. Assistants share your plan’s API limits.
Unknown OAuth client, or the connection is not recognisedRemove the Repostly connector in your assistant and add it again.
Connection expiredConnections last up to 90 days. Connect again to continue.

[!info] Info Not in a directory yet

Connect with the server URL above. Repostly is not listed in any assistant’s connector directory.

Every request

Authorization: Bearer rp_live_…
  • Paid plans only. Starter, Pro and Expert include API access. Without a plan only GET /me works; everything else returns 403 PLAN_REQUIRED with a link to upgrade.
  • Opaque and shown once. Keys are random secrets stored as hashes. Copy the key when you create it; Repostly cannot show it again.
  • You choose the lifetime. Pick 30 days to 1 year, or a key that never expires. GET /me returns key.expiresAt (null when it never expires).
  • Revocable at any time. Revoking blocks new requests immediately. It does not cancel posts that are already scheduled.

Scopes

A read scope never implies write. GET /me works with any scope.

ScopeAllows
accounts:readList connected accounts and read TikTok creator info
accounts:writeDisconnect connected social accounts (also deletes the account's workflows and stored data)
assets:readList and read uploaded media
assets:writeUpload media
posts:readList and read posts, including late posts
posts:writeCreate, replace and cancel posts; resolve late posts
workflows:readList workflows and read their activity
workflows:writeCreate, replace, pause, resume, delete and retry workflows
analytics:readAccount analytics and per-post analytics

A key without the required scope gets 403 INSUFFICIENT_SCOPE. Each operation in the reference lists its scope.

AI assistants do not use API keys: they connect through OAuth and you approve each permission when connecting. See Connect an AI assistant. They use the same scopes.

[!warning] Warning Keep keys on the server

Never put a key in a URL, a browser or mobile bundle, or source control. All keys of one account share its plan and rate limits.

A post is one piece of content sent to one or more destinations (connected accounts). Creating a post schedules it. Its ID stays the same across every destination and every edit.

Upload assets

There are two ways to upload. Both return an asset whose ID you use as videoAssetId, thumbnailAssetId or in imageAssetIds, and uploading the same file again returns the same asset.

Direct upload (recommended for videos)

The file goes straight to storage, so large videos are fast and reliable. Videos up to 500 MiB, images up to 20 MiB (MP4, MOV, JPEG, PNG).

  1. POST /uploads with contentType, the exact sizeBytes and an optional fileName. It needs an Idempotency-Key and returns an upload object with a URL that works for one hour.
  2. PUT the file bytes to upload.url with exactly upload.headers. Don't send your API key there. A different content type or size is rejected by storage.
  3. POST /uploads/{id}/complete returns 202 while the file is checked. 409 UPLOAD_NOT_RECEIVED means the file hasn't arrived yet: retry the PUT if it failed, then complete again.
  4. Poll GET /uploads/{id} every few seconds until status is ready (with assetId and asset) or failed (with error.code and a message, for example UNSUPPORTED_MEDIA or UPLOAD_SIZE_MISMATCH).

Direct upload

FILE=launch.mp4
SIZE=$(wc -c < "$FILE" | tr -d ' ')
# 1. Create the upload session
curl -X POST https://api.repostly.app/v1/uploads \
  -H "Authorization: Bearer $REPOSTLY_API_KEY" \
  -H 'Idempotency-Key: launch-upload-0001' \
  -H 'Content-Type: application/json' \
  -d "{\"contentType\": \"video/mp4\", \"sizeBytes\": $SIZE, \"fileName\": \"$FILE\"}"
# → { "id": "6650f1c2a4b3c2d1e0f98768", "upload": { "method": "PUT", "url": "https://…", ... } }

# 2. PUT the bytes to upload.url (no Authorization header)
UPLOAD_URL='<upload.url from step 1>'
curl -X PUT "$UPLOAD_URL" -H 'Content-Type: video/mp4' --upload-file "$FILE"

# 3. Complete, then poll until status is "ready"
curl -X POST https://api.repostly.app/v1/uploads/6650f1c2a4b3c2d1e0f98768/complete \
  -H "Authorization: Bearer $REPOSTLY_API_KEY"
curl https://api.repostly.app/v1/uploads/6650f1c2a4b3c2d1e0f98768 \
  -H "Authorization: Bearer $REPOSTLY_API_KEY"
# → { "status": "ready", "assetId": "6650f1c2a4b3c2d1e0f98766", ... }
  • Up to 3 uploads per account can wait for their file or be processing at once (409 TOO_MANY_UPLOADS). DELETE /uploads/{id} cancels one you won't finish. When you hit the limit, uploads whose file never arrived are cancelled automatically once they are old enough (UPLOAD_ABANDONED).
  • Up to 10 GiB can be declared per rolling 24 hours (429 UPLOAD_QUOTA_EXCEEDED).
  • 503 DIRECT_UPLOAD_UNAVAILABLE means direct uploads are switched off: use multipart upload instead.

Multipart upload (simple, up to 100 MiB)

POST /assets takes one multipart file part named file. The kind is detected from the file; add ?kind=image or ?kind=video to override it.

  • Up to 100 MiB per video and 20 MiB per image.
  • One upload per account at a time. A busy upload slot returns 429 with Retry-After.

Content kind is inferred

You sendKind
videoAssetIdvideo
imageAssetIds with 1 IDimage
imageAssetIds with 2–20 IDscarousel
No assettext

Sending a video and images together returns 400.

Placements

Call GET /capabilities (scope accounts:read) for the current content kinds, placements, defaults, destination fields and workflow types. Filter with ?platform=threads. These are Repostly capabilities; account eligibility and media checks still apply.

Set placement per destination, or leave it out to get the default (bold).

PlatformVideoImageCarouselText
YouTubevideo shorts———
Instagramreelsimagecarousel—
Facebookvideo reelsimagecarousel—
Threadsvideoimagecarouseltext
TikTokvideoimagecarousel—

Create a post

POST /posts

{
  "caption": "Launch day!",
  "scheduledAt": "2027-06-01T09:00:00+02:00",
  "timezone": "Europe/Berlin",
  "videoAssetId": "6650f1c2a4b3c2d1e0f98766",
  "destinations": [
    { "accountId": "…instagram", "placement": "reels", "shareToFeed": true },
    { "accountId": "…youtube", "placement": "shorts", "title": "Launch day", "tags": ["launch"] },
    {
      "accountId": "…tiktok",
      "tiktokPrivacyLevel": "PUBLIC_TO_EVERYONE",
      "allowComments": true,
      "tiktokConsent": { "contentSharingConfirmed": true, "musicUsageConfirmed": true }
    }
  ]
}
  • scheduledAt is optional. Leave it out to publish on the next scheduler run. More than 60 seconds in the past returns 400 SCHEDULE_IN_PAST.
  • timezone (default UTC) is display context only. It never shifts scheduledAt.
  • PUT /posts/{id} replaces a pending post with a full body. Read GET /posts/{id}, change it, send it back (for TikTok destinations add fresh tiktokConsent; it is never returned). Once processing starts it returns 409.
  • DELETE /posts/{id} cancels a pending post. It never deletes content that is already live on a platform.

Destination options

Every destination needs accountId. Platform options sit next to it:

PlatformOptions
Allcaption (overrides the post caption)
YouTubetitle description tags categoryId visibility notifySubscribers selfDeclaredMadeForKids containsSyntheticMedia
InstagramshareToFeed thumbOffsetMs altText aiGenerated
Facebooktitle description altText aiGenerated
ThreadsreplyControl topicTag altText
TikToktiktokPrivacyLevel allowComments allowDuet allowStitch commercialContent brandedContent promoteBrand aiContent tiktokPhotoTitle tiktokAutoAddMusic tiktokConsent

visibility is public, unlisted or private for YouTube video, and defaults to public, like the app. On YouTube title is the video title: at most 100 characters, without < or >. Options a platform doesn't use are rejected.

Audio is converted for you

If a destination can't accept a video's audio, Repostly converts it before publishing. There is no extra step. Failures show up in the destination's error.

TikTok: creator info and consent

  1. Call GET /accounts/{id}/tiktok-creator-info right before you show the publish form.
  2. Show the creator the privacy levels, interaction settings and maximum duration it returns, plus a preview of the content.
  3. Send their explicit choices: tiktokPrivacyLevel, allowComments / allowDuet / allowStitch, disclosure flags and tiktokConsent. Collect consent again for every create and every PUT: stored consent is never returned or reused.

[!warning] Warning An API key is not consent

Your integration must collect consent from the creator, following TikTok's content sharing guidelines. Repostly checks the creator's capabilities again when the post is due.

Status

Use GET /posts with destinationStatus=scheduled to find pending destinations, status=failed for any failed destination (including partial failures), or status=cancelled for fully cancelled posts. Filters apply before pagination and retain every destination of a matching parent. With accountId, the destination-status match must be on that account. Keep filters unchanged while following cursors.

A post's status sums up its destinations: scheduled, publishing, published, partially_published, failed, paused or cancelled. Each destination has its own status, url, error and latest metrics.

A workflow watches a source account and reposts to a destination account. Create one with POST /workflows (an Idempotency-Key is required).

POST /workflows

{
  "sourceAccountId": "6650f1c2a4b3c2d1e0f98765",
  "destinationAccountId": "6650f1c2a4b3c2d1e0f98766",
  "sourceContent": "reels",
  "destinationContent": "shorts",
  "mode": "backlog",
  "backlog": {
    "order": "from_date",
    "startAt": "2026-01-01T00:00:00Z",
    "timezone": "Europe/Berlin",
    "postTimes": ["09:00", "18:30"]
  }
}
FieldValues
modenew_posts reposts what's published from now on. backlog works through older posts and needs backlog.
sourceContent, destinationContentreels, video, videos, shorts, text, image, carousel
backlog.orderoldest_first (default) or from_date, which starts at backlog.startAt
backlog.postTimes1–24 unique 24-hour times, such as "09:00", in backlog.timezone
tiktokDeclarationRequired when the destination is TikTok

Run and inspect

  • POST /workflows/{id}/pause and POST /workflows/{id}/resume stop and restart processing. Pausing never recalls posts already handed to publishing.
  • PUT /workflows/{id} replaces the settings and reactivates the workflow, as in the app.
  • GET /workflows/{id}/activity returns items being processed (with a blockedReason when stuck), the posts the workflow created and failed deliveries (failedPosts). Each processing item has a generation. The three lists page separately with processingCursor, postsCursor and failedPostsCursor. If the failed list cannot be read, it comes back empty with available: false instead of failing the whole response.
  • POST /workflows/{id}/preparations/{preparationId}/retry retries a blocked item with the generation shown in the activity. POST /workflows/{id}/posts/{postId}/retry queues a failed delivery again when its retryable flag is true. Retries need an active workflow with connected accounts; otherwise they return 409 (WORKFLOW_UNAVAILABLE, WORKFLOW_ACCOUNT_UNAVAILABLE, WORKFLOW_POST_DESTINATION_CHANGED) and change nothing.
  • DELETE /workflows/{id} returns 204. Content already published stays live.

Unsupported routes and loops are rejected; a loop returns 508. You need the rights to repost the source content.

EndpointReturns
GET /analytics/summaryTotals for views, likes, comments, followers and posts, with change vs. the previous period
GET /analytics/timeseriesOne metric over time: metric=views|likes|comments|followers, in hourly (24h), daily or weekly (all) buckets that start on boundaries in your timezone
GET /analytics/top-postsBest-performing posts, with the same IDs as /posts
GET /analytics/best-timesAudience activity: view growth by the hour of day (0–23) it was recorded, in your timezone. Use it to pick posting times; it is not grouped by when posts were published
GET /posts/{id}/analyticsEngagement over time for one post

Filter with range (24h, 7d, 30d, 365d, all; default 30d), accountId and platform. Top posts and per-post analytics accept 24h, 7d and 30d. For timeseries, endAt (default now) is aligned down to the start of its hour, day or Monday week, and that bucket is the last point.

Disconnecting an account deletes its stored analytics.

Shell

curl 'https://api.repostly.app/v1/analytics/timeseries?metric=views&range=7d&timezone=Europe/Berlin' \
  -H "Authorization: Bearer $REPOSTLY_API_KEY"

Response (abridged)

{
  "metric": "views",
  "range": "7d",
  "timezone": "Europe/Berlin",
  "points": [{ "at": "2026-10-26T00:00:00.000Z", "value": 1840 }],
  "coverage": { ... }
}

[!info] Info Stored, not live

Analytics come from Repostly's stored observations and can lag by up to an hour. A missing value is not zero, and changePercent is null when there is no baseline.

Cursor pagination

Every list returns { "data": [...], "nextCursor": "…" | null }. Pass limit (1–100, default 20) and the previous nextCursor as cursor. Treat cursors as opaque; a malformed one returns 400 INVALID_CURSOR.

Keep filters and limit unchanged while following cursors. The account, post and workflow lists bind the cursor to its limit, so a different limit returns INVALID_CURSOR; the asset list, late posts and the workflow activity cursors accept a changed limit. GET /workflows/{id}/activity holds three lists, each with its own cursor: pass processing.nextCursor as processingCursor, posts.nextCursor as postsCursor and failedPosts.nextCursor as failedPostsCursor. limit applies to each list.

Read every post

let cursor = null;
do {
  const url = new URL('https://api.repostly.app/v1/posts');
  url.searchParams.set('limit', '100');
  if (cursor) url.searchParams.set('cursor', cursor);
  const response = await fetch(url, {
    headers: { Authorization: \`Bearer ${process.env.REPOSTLY_API_KEY}\` },
  });
  const page = await response.json();
  for (const post of page.data) console.log(post.id, post.status);
  cursor = page.nextCursor;
} while (cursor);

Times

InputsISO 8601 with an offset or Z (2027-06-01T10:00:00+02:00), or Unix milliseconds (1811836800000)
OutputsAlways ISO 8601 in UTC: 2027-06-01T08:00:00.000Z
timezoneAn IANA name such as Europe/Berlin. Used for display, emails and daily buckets. It never changes an absolute time.

IDs and enums

IDs are 24-character hex strings. Posts imported from a connected account use imported:<hex>. Enum values are lowercase, except values defined by a platform such as TikTok's PUBLIC_TO_EVERYONE.

400 Bad Request

{
  "error": {
    "code": "INVALID_REQUEST",
    "message": "Check the highlighted fields.",
    "requestId": "9bd8d90b-3156-4c55-ad11-65b29d5c5eed",
    "details": {
      "fields": [{ "field": "destinations[0].accountId", "message": "is required" }]
    }
  }
}
StatusCodeMeaning
400INVALID_REQUEST UNKNOWN_FIELDA field is missing, malformed or not part of the schema. See details.fields.
400INVALID_CURSOR SCHEDULE_IN_PAST IDEMPOTENCY_KEY_REQUIREDBad cursor, a time too far in the past, or a missing Idempotency-Key.
401INVALID_API_KEYKey missing, invalid, expired or revoked.
403PLAN_REQUIRED INSUFFICIENT_SCOPENo paid plan, or the key lacks the scope.
404ACCOUNT_NOT_FOUND WORKFLOW_NOT_FOUND WORKFLOW_PREPARATION_NOT_FOUND WORKFLOW_POST_NOT_FOUNDThe resource doesn't exist or belongs to another account. DELETE /accounts/{id} returns ACCOUNT_NOT_FOUND once the account is already gone, so a repeated disconnect can treat it as done.
409IDEMPOTENCY_CONFLICT REQUEST_UNCONFIRMEDKey reused with different input, or an earlier attempt is unconfirmed. Also returned when a post is already processing.
409TOO_MANY_UPLOADS UPLOAD_NOT_RECEIVEDDirect uploads: 3 already running, or complete was called before the file arrived (retry the PUT, then complete).
409WORKFLOW_UNAVAILABLE WORKFLOW_ACCOUNT_UNAVAILABLEWorkflow retries: the workflow is paused (resume it first), or its source or destination account is disconnected, needs reconnecting or is halted by the plan allowance.
409WORKFLOW_POST_NOT_RETRYABLE WORKFLOW_POST_DESTINATION_CHANGEDThe delivery is not failed (for example already retried), or the workflow now publishes to a different account than the failed delivery.
409WORKFLOW_PREPARATION_CONFLICT WORKFLOW_CHANGED WORKFLOW_RECONCILIATION_REQUIRED WORKFLOW_LOOPThe processing item is no longer blocked, its generation changed, or it cannot be retried now. Read the workflow activity again. A rejected retry changes nothing. WORKFLOW_LOOP is a 409 when you retry a workflow preparation that would repost into itself.
413ASSET_UPLOAD_TOO_LARGEFile larger than the upload limit.
415—Wrong content type (JSON expected, or multipart for uploads).
422—Content or consent not compatible with a destination.
429RATE_LIMITED UPLOAD_BUSY UPLOAD_QUOTA_EXCEEDEDRate limit, upload slot or daily direct-upload volume exhausted. Wait for Retry-After.
503DIRECT_UPLOAD_UNAVAILABLE ACCOUNT_DISCONNECT_FAILED WORKFLOW_PREPARATION_DISABLED WORKFLOW_PREPARATION_UNAVAILABLETemporarily unavailable. Retry with the same Idempotency-Key. DIRECT_UPLOAD_UNAVAILABLE: use multipart POST /assets. ACCOUNT_DISCONNECT_FAILED: the account still exists; retry the disconnect. WORKFLOW_PREPARATION_DISABLED: preparation retries are not available right now. WORKFLOW_PREPARATION_UNAVAILABLE: workflow preparations could not be read or changed; try again shortly.
508WORKFLOW_LOOPThe workflow would repost into itself (WORKFLOW_LOOP). This is the status when creating, replacing or resuming a workflow; retrying a workflow preparation returns 409 instead.

New codes can appear at any time; fall back to the HTTP status for codes you don't know. Quote requestId (also sent as the X-Request-Id header) when you contact support.

Send an Idempotency-Key header (8–128 letters, digits, . _ : -) with each logical write that accepts one.

RequiredPOST /posts, POST /workflows, POST /posts/late/resolve, POST /uploads
OptionalPUT, DELETE (including DELETE /uploads/{id} to cancel an upload), POST /uploads/{id}/complete, workflow pause, resume and retries. Honored when sent.
Not usedPOST /assets. Uploading the same file again returns the same asset.
Kept for30 days
  • Same key, same input: the original response is replayed with Idempotency-Replayed: true.
  • Same key, different input: 409 IDEMPOTENCY_CONFLICT.
  • Earlier attempt still running or unconfirmed: 409 REQUEST_UNCONFIRMED. Check the resource before acting again.

When to retry

ResponseDo this
Timeout, network error, 5xxRetry with the same key and body, with exponential backoff. A 5xx that happened before anything changed frees the key for that retry; if the retry replays a 5xx (Idempotency-Replayed: true), the outcome is unconfirmed: read the post, workflow or upload before acting again.
429Wait Retry-After seconds, then retry with the same key.
409 REQUEST_UNCONFIRMEDRead the post, workflow or upload to see whether it was created. Don't switch to a new key.
Other 4xxFix the request. Retrying won't help.

AI assistants call the same operations as MCP tools. The tools that need a key take an idempotencyKey argument, and the same rules apply: reuse it when retrying, use a new one only for a new action.

[!warning] Warning Use a new key only for a new, deliberate action. Two keys mean two posts, even with the same caption and media.

BucketStarterProExpert
All requests total120300600
Writes writes3060120
Uploads uploads61220
Analytics analytics3060120
TikTok creator info creatorInfo666
  • Windows are fixed UTC minutes. Every request counts toward total; writes, uploads, analytics and creator info also count toward their own bucket. Failed requests and replays count too.
  • Responses carry X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset (epoch seconds), plus headers for the bucket used.
  • A 429 includes Retry-After in seconds. Each operation in the reference names its bucket.

Writes include creating, replacing and cancelling posts, workflow changes and retries, and disconnecting accounts. AI assistants connected through MCP spend the same budget as your API keys.

Social platforms' own publishing limits apply on top of these.

The version is in the path: /v1. Within v1 we only make additive changes: new endpoints, new optional fields, new enum values and new error codes. Ignore fields you don't know. Breaking changes ship as a new version, announced in advance.

  1. 2026-11-01 MCP server. AI assistants such as Claude and ChatGPT can connect to https://server.repostly.app/mcp and call the same operations as tools. MCP signs in with OAuth and per-permission consent instead of API keys; the same plan, scopes, rate limits and idempotency apply. See Connect an AI assistant.
  2. 2026-11-01 Workflow retries. POST /workflows/{id}/preparations/{preparationId}/retry and POST /workflows/{id}/posts/{postId}/retry. GET /workflows/{id}/activity now returns failedPosts (with retryable and available), each processing item's generation and a failedPostsCursor. New error codes: WORKFLOW_UNAVAILABLE, WORKFLOW_POST_NOT_RETRYABLE, WORKFLOW_POST_DESTINATION_CHANGED, WORKFLOW_ACCOUNT_UNAVAILABLE and WORKFLOW_PREPARATION_*.
  3. 2026-11-01 Account disconnect. DELETE /accounts/{id} with the new accounts:write scope. It also deletes workflows using the account and its stored analytics; the provider authorization is not revoked. Full-access keys do not include it; select it explicitly. Errors: ACCOUNT_NOT_FOUND (already gone) and the retryable 503 ACCOUNT_DISCONNECT_FAILED.
  4. 2026-11-01 Capability discovery and post filters. GET /capabilities lists supported content kinds, placements, defaults and workflow types. GET /posts accepts status (all, current, failed, cancelled) and destinationStatus filters.
  5. v1 · preview Posts, assets (multipart and direct uploads up to 500 MiB), workflows, analytics and TikTok creator info. Cursor pagination, ISO 8601 times, required idempotency keys and one error envelope. OpenAPI document version 1.0.0.

Every endpoint

35 operations, generated from the OpenAPI document (version 1.0.0). Examples show the shape; replace IDs and times with your own.

Your Repostly plan, this key's scopes and expiry, your per-minute rate limits and useful app links. Works with any scope and without a paid plan (plan is "none" then; every other operation returns 403 PLAN_REQUIRED — upgrade at https://app.repostly.app/upgrade).

Errors

Request

curl 'https://api.repostly.app/v1/me' \
  -H "Authorization: Bearer $REPOSTLY_API_KEY"

Response · 200 OK

{
  "userId": "6650f1c2a4b3c2d1e0f98765",
  "plan": "starter",
  "key": {
    "id": "6650f1c2a4b3c2d1e0f98766",
    "name": "My brand",
    "scopes": [
      "string"
    ],
    "expiresAt": "2027-06-01T09:00:00.000Z"
  },
  "rateLimits": {
    "windowSeconds": 60,
    "total": 1,
    "writes": 1,
    "uploads": 1,
    "analytics": 1,
    "creatorInfo": 1
  },
  "links": {
    "app": "string",
    "connectAccounts": "string",
    "upgrade": "string",
    "docs": "string"
  }
}

Implemented content kinds, placements, defaults, destination fields and workflow source/destination types per platform. Read before preparing posts or workflows. Account status, media compatibility, rights and live TikTok creator choices remain separate checks.

Parameters

NameInDescription
platform stringOptionalquery- One of instagram facebook tiktok youtube threads

Errors

Request

curl 'https://api.repostly.app/v1/capabilities' \
  -H "Authorization: Bearer $REPOSTLY_API_KEY"

Response · 200 OK

{
  "platforms": [
    {
      "platform": "instagram",
      "publishing": [
        {
          "kind": "string",
          "placements": [
            "string"
          ],
          "defaultPlacement": "string"
        }
      ],
      "destinationFields": [
        "string"
      ],
      "workflowSourceTypes": [
        "string"
      ],
      "workflowDestinationTypes": [
        "string"
      ],
      "requiresCreatorInfo": true
    }
  ],
  "notes": [
    "string"
  ]
}

Social accounts connected in the Repostly app (connect or reconnect them at links.connectAccounts from GET /me). Provider credentials are never returned.

Parameters

NameInDescription
platform stringOptionalqueryOnly accounts on this platform. - One of instagram facebook tiktok youtube threads
limit integerOptionalqueryItems per page (1–100, default 20). - Range 1–100
cursor stringOptionalqueryOpaque nextCursor from the previous page. - Length 1–512 chars

Errors

Request

curl 'https://api.repostly.app/v1/accounts' \
  -H "Authorization: Bearer $REPOSTLY_API_KEY"

Response · 200 OK

{
  "data": [
    {
      "id": "6650f1c2a4b3c2d1e0f98766",
      "platform": "instagram",
      "name": "My brand",
      "status": "active",
      "followers": 5210,
      "pages": [
        {
          "id": "6650f1c2a4b3c2d1e0f98766",
          "name": "My brand"
        }
      ],
      "lastSyncedAt": "2027-06-01T09:00:00.000Z"
    }
  ],
  "nextCursor": "eyJwYWdlIjoyfQ"
}

One connected account. pages lists selectable pages when the connection has them; otherwise it is empty.

Parameters

NameInDescription
id stringRequiredpath24-character hexadecimal ID. - Pattern ^[a-fA-F0-9]{24}$

Errors

Request

curl 'https://api.repostly.app/v1/accounts/6650f1c2a4b3c2d1e0f98766' \
  -H "Authorization: Bearer $REPOSTLY_API_KEY"

Response · 200 OK

{
  "id": "6650f1c2a4b3c2d1e0f98766",
  "platform": "instagram",
  "name": "My brand",
  "status": "active",
  "followers": 5210,
  "pages": [
    {
      "id": "6650f1c2a4b3c2d1e0f98766",
      "name": "My brand"
    }
  ],
  "lastSyncedAt": "2027-06-01T09:00:00.000Z"
}

Removes the account from Repostly (204), as deleting the connection in the app does. Also deleted: every workflow that uses the account as source or destination; all of Repostly's media records on the account, which are its imported posts and the delivery records of posts published to it (workflow deliveries and their metrics); and its stored analytics. Posts scheduled in Repostly keep their destination status, and workflow posts on other accounts are kept. Its paused destinations fail now and its scheduled destinations fail with connection_unavailable when due; other destinations of the same posts still publish. Content already live on the platform is not deleted, and the platform's own authorization is not revoked (remove Repostly in the platform's settings for that). Reconnecting later happens in the app and does not restore deleted workflows. An Idempotency-Key is optional and honored when sent. Non-final outcomes are not saved: errors returned before any change was made, every 429 and transient capacity or state conflicts (such as 409 POST_BUSY); retry those with the same key after Retry-After.

Parameters

NameInDescription
id stringRequiredpath24-character hexadecimal ID. - Pattern ^[a-fA-F0-9]{24}$
Idempotency-Key stringOptionalheaderOptional. When sent, retries with the same key and input replay the first result. - Length 8–128 chars - Pattern ^[A-Za-z0-9_.:-]{8,128}$

Errors

Request

curl -X DELETE 'https://api.repostly.app/v1/accounts/6650f1c2a4b3c2d1e0f98766' \
  -H "Authorization: Bearer $REPOSTLY_API_KEY" \
  -H 'Idempotency-Key: disconnectAccount-0001'

Response · 204 No Content

Empty body.

Live TikTok creator capabilities: nickname, allowed privacy levels, whether comments/duets/stitches are available and the maximum video duration. TikTok requires showing these choices and collecting explicit consent before posting; use them to fill the TikTok destination fields of POST /posts. Only for TikTok accounts.

Parameters

NameInDescription
id stringRequiredpath24-character hexadecimal ID. - Pattern ^[a-fA-F0-9]{24}$

Errors

Request

curl 'https://api.repostly.app/v1/accounts/6650f1c2a4b3c2d1e0f98766/tiktok-creator-info' \
  -H "Authorization: Bearer $REPOSTLY_API_KEY"

Response · 200 OK

{
  "creatorNickname": "My brand",
  "creatorUsername": "My brand",
  "creatorAvatarUrl": "https://example.com/media/launch.mp4",
  "privacyLevelOptions": [
    "string"
  ],
  "commentDisabled": true,
  "duetDisabled": true,
  "stitchDisabled": true,
  "maxVideoPostDurationSec": 1,
  "checkedAt": "2027-06-01T09:00:00.000Z"
}

Your uploaded originals, newest first.

Parameters

NameInDescription
kind stringOptionalqueryOnly this kind. - One of video image
limit integerOptionalqueryItems per page (1–100, default 20). - Range 1–100
cursor stringOptionalqueryOpaque nextCursor from the previous page. - Length 1–512 chars

Errors

Request

curl 'https://api.repostly.app/v1/assets' \
  -H "Authorization: Bearer $REPOSTLY_API_KEY"

Response · 200 OK

{
  "data": [
    {
      "id": "6650f1c2a4b3c2d1e0f98766",
      "kind": "video",
      "sizeBytes": 48211327,
      "contentType": "video/mp4",
      "url": "https://example.com/media/launch.mp4",
      "createdAt": "2027-06-01T09:00:00.000Z",
      "width": 1080,
      "height": 1920,
      "durationSeconds": 27.5
    }
  ],
  "nextCursor": "eyJwYWdlIjoyfQ"
}

multipart/form-data with exactly one file part named file (mediaFile is accepted too). The kind is inferred from the file (JPEG/PNG → image, MP4/MOV → video);?kind= overrides it. Limits: video 100 MiB, image 20 MiB, one upload at a time per account. Uploading the same file again returns the same asset. Remote URLs are not fetched: upload the bytes.

Parameters

NameInDescription
kind stringOptionalqueryOverride the inferred kind. - One of video image

Request body multipart/form-data

NameDescription
file fileRequiredThe video or image (alias: mediaFile).

Errors

Request

curl -X POST 'https://api.repostly.app/v1/assets' \
  -H "Authorization: Bearer $REPOSTLY_API_KEY" \
  -F 'file=@launch.mp4'

Response · 201 Created

{
  "id": "6650f1c2a4b3c2d1e0f98766",
  "kind": "video",
  "sizeBytes": 48211327,
  "contentType": "video/mp4",
  "url": "https://example.com/media/launch.mp4",
  "createdAt": "2027-06-01T09:00:00.000Z",
  "width": 1080,
  "height": 1920,
  "durationSeconds": 27.5
}

One uploaded original.

Parameters

NameInDescription
id stringRequiredpath24-character hexadecimal ID. - Pattern ^[a-fA-F0-9]{24}$

Errors

Request

curl 'https://api.repostly.app/v1/assets/6650f1c2a4b3c2d1e0f98766' \
  -H "Authorization: Bearer $REPOSTLY_API_KEY"

Response · 200 OK

{
  "id": "6650f1c2a4b3c2d1e0f98766",
  "kind": "video",
  "sizeBytes": 48211327,
  "contentType": "video/mp4",
  "url": "https://example.com/media/launch.mp4",
  "createdAt": "2027-06-01T09:00:00.000Z",
  "width": 1080,
  "height": 1920,
  "durationSeconds": 27.5
}

Recommended for videos (up to 500 MiB; images up to 20 MiB). Returns a one-hour presigned upload URL: PUT the file bytes there with exactly upload.headers (no Authorization header), then call POST /uploads/{id}/complete and poll GET /uploads/{id} until status is ready; asset.id is then usable as videoAssetId, thumbnailAssetId or in imageAssetIds. At most 3 uploads may be awaiting upload or processing per account (409 TOO_MANY_UPLOADS; uploads whose file never arrived are cancelled automatically once old enough, or cancel them with DELETE /uploads/{id}), and 10 GiB may be declared per rolling 24 hours (429 UPLOAD_QUOTA_EXCEEDED). 503 DIRECT_UPLOAD_UNAVAILABLE: use multipart POST /assets instead. Requires an Idempotency-Key: retry with the same key and body after a timeout; the original result is replayed (Idempotency-Replayed: true, with its Retry-After). Keys are remembered for 30 days. Non-final outcomes are not saved: errors returned before any change was made, every 429 and transient capacity or state conflicts (such as 409 POST_BUSY); retry those with the same key after Retry-After.

Parameters

NameInDescription
Idempotency-Key stringRequiredheaderUnique per logical action. Retry with the same key and body after a timeout; remembered for 30 days. - Length 8–128 chars - Pattern ^[A-Za-z0-9_.:-]{8,128}$

Request body application/json

NameDescription
kind stringOptionalOptional; inferred from contentType and must match it. - One of video image
contentType stringRequiredThe file's MIME type. Signed into the upload URL. - One of video/mp4 video/quicktime image/jpeg image/png
sizeBytes integerRequiredExact file size in bytes (video ≤ 524288000 = 500 MiB, image ≤ 20971520 = 20 MiB). Signed into the upload URL. - Range ≥ 1
fileName stringOptionalDisplay name only (stored up to 200 characters). - Length ≤ 255 chars

Errors

Request

curl -X POST 'https://api.repostly.app/v1/uploads' \
  -H "Authorization: Bearer $REPOSTLY_API_KEY" \
  -H 'Idempotency-Key: createUpload-0001' \
  -H 'Content-Type: application/json' \
  -d '{
    "kind": "video",
    "contentType": "video/mp4",
    "sizeBytes": 471859200,
    "fileName": "launch.mp4"
  }'

Response · 201 Created

{
  "id": "6650f1c2a4b3c2d1e0f98766",
  "kind": "video",
  "status": "awaiting_upload",
  "sizeBytes": 48211327,
  "contentType": "video/mp4",
  "fileName": "My brand",
  "createdAt": "2027-06-01T09:00:00.000Z",
  "expiresAt": "2027-06-01T09:00:00.000Z",
  "assetId": "6650f1c2a4b3c2d1e0f98766",
  "asset": {
    "id": "6650f1c2a4b3c2d1e0f98766",
    "kind": "video",
    "sizeBytes": 48211327,
    "contentType": "video/mp4",
    "url": "https://example.com/media/launch.mp4",
    "createdAt": "2027-06-01T09:00:00.000Z",
    "width": 1080,
    "height": 1920,
    "durationSeconds": 27.5
  },
  "error": {
    "code": "string",
    "message": "Human-readable explanation."
  },
  "upload": {
    "method": "PUT",
    "url": "https://example.com/media/launch.mp4",
    "headers": {
      "Content-Type": "string",
      "Content-Length": "string"
    },
    "expiresAt": "2027-06-01T09:00:00.000Z"
  },
  "maxBytes": 1
}

The upload's status. Poll every few seconds while processing (verification of a 500 MiB video usually takes well under a minute); ready includes the asset, failed includes error.code and a message. Polling also resumes verification interrupted by a server restart.

Parameters

NameInDescription
id stringRequiredpath24-character hexadecimal ID. - Pattern ^[a-fA-F0-9]{24}$

Errors

Request

curl 'https://api.repostly.app/v1/uploads/6650f1c2a4b3c2d1e0f98766' \
  -H "Authorization: Bearer $REPOSTLY_API_KEY"

Response · 200 OK

{
  "id": "6650f1c2a4b3c2d1e0f98766",
  "kind": "video",
  "status": "awaiting_upload",
  "sizeBytes": 48211327,
  "contentType": "video/mp4",
  "fileName": "My brand",
  "createdAt": "2027-06-01T09:00:00.000Z",
  "expiresAt": "2027-06-01T09:00:00.000Z",
  "assetId": "6650f1c2a4b3c2d1e0f98766",
  "asset": {
    "id": "6650f1c2a4b3c2d1e0f98766",
    "kind": "video",
    "sizeBytes": 48211327,
    "contentType": "video/mp4",
    "url": "https://example.com/media/launch.mp4",
    "createdAt": "2027-06-01T09:00:00.000Z",
    "width": 1080,
    "height": 1920,
    "durationSeconds": 27.5
  },
  "error": {
    "code": "string",
    "message": "Human-readable explanation."
  }
}

Cancels an upload that was not completed (status cancelled) so it stops counting toward the 3 concurrent uploads. Finished uploads are returned unchanged; 409 UPLOAD_PROCESSING once complete was called. Never deletes a ready asset. An Idempotency-Key is optional and honored when sent. Non-final outcomes are not saved: errors returned before any change was made, every 429 and transient capacity or state conflicts (such as 409 POST_BUSY); retry those with the same key after Retry-After.

Parameters

NameInDescription
id stringRequiredpath24-character hexadecimal ID. - Pattern ^[a-fA-F0-9]{24}$
Idempotency-Key stringOptionalheaderOptional. When sent, retries with the same key and input replay the first result. - Length 8–128 chars - Pattern ^[A-Za-z0-9_.:-]{8,128}$

Errors

Request

curl -X DELETE 'https://api.repostly.app/v1/uploads/6650f1c2a4b3c2d1e0f98766' \
  -H "Authorization: Bearer $REPOSTLY_API_KEY" \
  -H 'Idempotency-Key: cancelUpload-0001'

Response · 200 OK

{
  "id": "6650f1c2a4b3c2d1e0f98766",
  "kind": "video",
  "status": "awaiting_upload",
  "sizeBytes": 48211327,
  "contentType": "video/mp4",
  "fileName": "My brand",
  "createdAt": "2027-06-01T09:00:00.000Z",
  "expiresAt": "2027-06-01T09:00:00.000Z",
  "assetId": "6650f1c2a4b3c2d1e0f98766",
  "asset": {
    "id": "6650f1c2a4b3c2d1e0f98766",
    "kind": "video",
    "sizeBytes": 48211327,
    "contentType": "video/mp4",
    "url": "https://example.com/media/launch.mp4",
    "createdAt": "2027-06-01T09:00:00.000Z",
    "width": 1080,
    "height": 1920,
    "durationSeconds": 27.5
  },
  "error": {
    "code": "string",
    "message": "Human-readable explanation."
  }
}

Call after the PUT succeeded. Starts verification (202, status processing): the size must equal sizeBytes and the content must be an MP4/MOV video or a JPEG/PNG image. Identical bytes already in your library return that asset. 409 UPLOAD_NOT_RECEIVED: the file is not in storage yet; retry the PUT if it failed, then complete again (the URL works until expiresAt). Send no body or {}. An Idempotency-Key is optional and honored when sent. Non-final outcomes are not saved: errors returned before any change was made, every 429 and transient capacity or state conflicts (such as 409 POST_BUSY); retry those with the same key after Retry-After.

Parameters

NameInDescription
id stringRequiredpath24-character hexadecimal ID. - Pattern ^[a-fA-F0-9]{24}$
Idempotency-Key stringOptionalheaderOptional. When sent, retries with the same key and input replay the first result. - Length 8–128 chars - Pattern ^[A-Za-z0-9_.:-]{8,128}$

Errors

Request

curl -X POST 'https://api.repostly.app/v1/uploads/6650f1c2a4b3c2d1e0f98766/complete' \
  -H "Authorization: Bearer $REPOSTLY_API_KEY" \
  -H 'Idempotency-Key: completeUpload-0001'

Response · 200 OK

{
  "id": "6650f1c2a4b3c2d1e0f98766",
  "kind": "video",
  "status": "awaiting_upload",
  "sizeBytes": 48211327,
  "contentType": "video/mp4",
  "fileName": "My brand",
  "createdAt": "2027-06-01T09:00:00.000Z",
  "expiresAt": "2027-06-01T09:00:00.000Z",
  "assetId": "6650f1c2a4b3c2d1e0f98766",
  "asset": {
    "id": "6650f1c2a4b3c2d1e0f98766",
    "kind": "video",
    "sizeBytes": 48211327,
    "contentType": "video/mp4",
    "url": "https://example.com/media/launch.mp4",
    "createdAt": "2027-06-01T09:00:00.000Z",
    "width": 1080,
    "height": 1920,
    "durationSeconds": 27.5
  },
  "error": {
    "code": "string",
    "message": "Human-readable explanation."
  }
}

Posts created in Repostly (scheduled in the app or via the API, or by workflows) and posts imported from your connected accounts, newest scheduledAt first, with per-destination status.

Parameters

NameInDescription
accountId stringOptionalqueryOnly posts with a destination on this account. - Pattern ^[a-fA-F0-9]{24}$
kind stringOptionalqueryOnly this content kind. - One of video image carousel text
status stringOptionalqueryDefault all. current excludes fully cancelled posts; failed includes any failed destination (including partial failures); cancelled means all destinations were cancelled. Applied before pagination. - One of all current failed cancelled
destinationStatus stringOptionalqueryOnly posts with a destination in this state, within accountId when supplied. For example scheduled finds pending destinations. Other destinations of each matching parent remain in the result. Applied before pagination. - One of scheduled queued processing published failed unknown cancelled paused
from string (date-time) | integerOptionalqueryOnly posts scheduled at or after this time. ISO 8601 date-time with offset or Unix milliseconds.
to string (date-time) | integerOptionalqueryOnly posts scheduled before this time. ISO 8601 date-time with offset or Unix milliseconds.
limit integerOptionalqueryItems per page (1–100, default 20). - Range 1–100
cursor stringOptionalqueryOpaque nextCursor from the previous page. - Length 1–512 chars

Errors

Request

curl 'https://api.repostly.app/v1/posts' \
  -H "Authorization: Bearer $REPOSTLY_API_KEY"

Response · 200 OK

{
  "data": [
    {
      "id": "6650f1c2a4b3c2d1e0f98766",
      "kind": "video",
      "caption": "Launch day!",
      "status": "scheduled",
      "scheduledAt": "2027-06-01T09:00:00.000Z",
      "timezone": "Europe/Berlin",
      "origin": "schedule",
      "workflowId": "6650f1c2a4b3c2d1e0f98765",
      "videoAssetId": "6650f1c2a4b3c2d1e0f98765",
      "thumbnailAssetId": "6650f1c2a4b3c2d1e0f98766",
      "imageAssetIds": [
        "6650f1c2a4b3c2d1e0f98768"
      ],
      "thumbnailUrl": "https://example.com/media/launch.mp4",
      "editable": true,
      "destinations": [
        {
          "id": "6650f1c2a4b3c2d1e0f98766",
          "accountId": "6650f1c2a4b3c2d1e0f98767",
          "accountName": "My brand",
          "platform": "instagram",
          "placement": "string",
          "status": "scheduled",
          "url": "https://example.com/media/launch.mp4",
          "publishedAt": "2027-06-01T09:00:00.000Z",
          "providerPostIds": [
            "6650f1c2a4b3c2d1e0f98766"
          ],
          "error": {
            "code": "string",
            "message": "Human-readable explanation."
          },
          "metrics": {
            "views": 1840,
            "likes": 132,
            "comments": 18,
            "observedAt": "2027-06-01T09:00:00.000Z"
          },
          "options": {
            "caption": "Launch day!",
            "title": "Launch day",
            "description": "string",
            "visibility": "public",
            "tags": [
              "string"
            ],
            "categoryId": "6650f1c2a4b3c2d1e0f98768",
            "selfDeclaredMadeForKids": true,
            "containsSyntheticMedia": true,
            "notifySubscribers": true,
            "shareToFeed": true,
            "thumbOffsetMs": 0,
            "altText": "string",
            "aiGenerated": true,
            "replyControl": "everyone",
            "topicTag": "string",
            "tiktokPrivacyLevel": "PUBLIC_TO_EVERYONE",
            "allowComments": true,
            "allowDuet": true,
            "allowStitch": true,
            "commercialContent": true,
            "brandedContent": true,
            "promoteBrand": true,
            "aiContent": true,
            "tiktokPhotoTitle": "string",
            "tiktokAutoAddMusic": true
          }
        }
      ]
    }
  ],
  "nextCursor": "eyJwYWdlIjoyfQ"
}

Schedules one piece of content to one or more connected accounts. The kind is inferred: videoAssetId → video, one image → image, 2–20 images → carousel, neither → text. Omit scheduledAt to publish on the next scheduler run. Audio a destination cannot accept is converted automatically before publishing. Publishing is asynchronous: watch each destination's status. Requires an Idempotency-Key: retry with the same key and body after a timeout; the original result is replayed (Idempotency-Replayed: true, with its Retry-After). Keys are remembered for 30 days. Non-final outcomes are not saved: errors returned before any change was made, every 429 and transient capacity or state conflicts (such as 409 POST_BUSY); retry those with the same key after Retry-After.

Parameters

NameInDescription
Idempotency-Key stringRequiredheaderUnique per logical action. Retry with the same key and body after a timeout; remembered for 30 days. - Length 8–128 chars - Pattern ^[A-Za-z0-9_.:-]{8,128}$

Request body application/json

NameDescription
caption stringOptionalShared caption. Required for text posts. - Length ≤ 4000 chars
scheduledAt string (date-time) | integerOptionalWhen to publish. On create, omit it (or send a time up to 60 s in the past) to publish on the next scheduler run. On replace (PUT), omit it to keep the post's current scheduled time. ISO 8601 date-time with offset or Unix milliseconds.
timezone stringOptionalIANA time zone for display and email context (default UTC). It never reinterprets scheduledAt. - Length 1–64 chars
videoAssetId stringOptionalUploaded video asset (makes this a video post). - Pattern ^[a-fA-F0-9]{24}$
thumbnailAssetId stringOptionalOptional uploaded image asset used as the video thumbnail. - Pattern ^[a-fA-F0-9]{24}$
imageAssetIds string[]OptionalUploaded image assets: one → image post, 2–20 → carousel. - Items ≤ 20 items - Unique items
destinations object[]Required- Items 1–50 items
destinations[].accountId stringRequiredConnected account ID from GET /accounts. - Pattern ^[a-fA-F0-9]{24}$
destinations[].placement stringOptionalWhere the content appears. Defaults: video posts → youtube video, instagram reels, facebook video, threads video, tiktok video; image → image; carousel → carousel; text → text. - One of video shorts reels image carousel text
destinations[].caption stringOptionalCaption for this destination only (overrides the post caption). - Length ≤ 4000 chars
destinations[].title stringOptionalYouTube: the video title, at most 100 characters without < or > (YouTube uses the caption as title). Facebook video: the video title (at most 200). - Length ≤ 200 chars
destinations[].description stringOptionalYouTube and Facebook video description. - Length ≤ 5000 chars
destinations[].visibility stringOptionalYouTube video visibility. Default public. - One of public unlisted private
destinations[].tags string[]OptionalYouTube tags. - Items ≤ 100 items
destinations[].categoryId stringOptionalYouTube category ID. - Length ≤ 3 chars
destinations[].selfDeclaredMadeForKids booleanOptionalYouTube: made for kids.
destinations[].containsSyntheticMedia booleanOptionalYouTube: altered or synthetic content disclosure.
destinations[].notifySubscribers booleanOptionalYouTube: notify subscribers.
destinations[].shareToFeed booleanOptionalInstagram Reels: also share to the feed.
destinations[].thumbOffsetMs integerOptionalInstagram Reels: cover frame offset in milliseconds. - Range 0–86400000
destinations[].altText stringOptionalImage alt text (Instagram, Facebook, Threads). - Length ≤ 1000 chars
destinations[].aiGenerated booleanOptionalInstagram / Facebook Reels: AI-generated label.
destinations[].replyControl stringOptionalThreads reply control. - One of everyone accounts_you_follow mentioned_only parent_post_author_only followers_only
destinations[].topicTag stringOptionalThreads topic tag. - Length ≤ 50 chars
destinations[].tiktokPrivacyLevel stringOptionalTikTok privacy level; must be one of privacyLevelOptions from tiktok-creator-info. - One of PUBLIC_TO_EVERYONE MUTUAL_FOLLOW_FRIENDS FOLLOWER_OF_CREATOR SELF_ONLY
destinations[].allowComments booleanOptionalTikTok: allow comments (explicit choice required).
destinations[].allowDuet booleanOptionalTikTok video: allow duets (explicit choice required).
destinations[].allowStitch booleanOptionalTikTok video: allow stitches (explicit choice required).
destinations[].commercialContent booleanOptionalTikTok: commercial content disclosure; true exactly when brandedContent or promoteBrand is true.
destinations[].brandedContent booleanOptionalTikTok: branded content (paid partnership).
destinations[].promoteBrand booleanOptionalTikTok: promotes your own brand.
destinations[].aiContent booleanOptionalTikTok: AI-generated content label.
destinations[].tiktokPhotoTitle stringOptionalTikTok photo posts: title (required for photo posts). - Length ≤ 90 chars
destinations[].tiktokAutoAddMusic booleanOptionalTikTok photo posts: let TikTok add music (required for photo posts).
destinations[].tiktokConsent objectOptionalExplicit TikTok creator consent collected in your UI for this post. Required for TikTok destinations on every create and every replace (PUT); GET never returns stored consent.
destinations[].tiktokConsent.contentSharingConfirmed booleanRequiredThe creator confirmed TikTok's content sharing terms.
destinations[].tiktokConsent.musicUsageConfirmed booleanRequiredThe creator confirmed TikTok's music usage confirmation.
destinations[].tiktokConsent.brandedContentPolicyConfirmed booleanOptionalRequired when brandedContent is true.

Errors

Request

curl -X POST 'https://api.repostly.app/v1/posts' \
  -H "Authorization: Bearer $REPOSTLY_API_KEY" \
  -H 'Idempotency-Key: createPost-0001' \
  -H 'Content-Type: application/json' \
  -d '{
    "caption": "Launch day!",
    "scheduledAt": "2027-06-01T09:00:00+02:00",
    "timezone": "Europe/Berlin",
    "videoAssetId": "64b7f0c2a1e4d3b2c1f0e9d8",
    "destinations": [
      {
        "accountId": "507f1f77bcf86cd799439011",
        "placement": "reels",
        "caption": "IG-specific caption",
        "shareToFeed": true
      },
      {
        "accountId": "507f1f77bcf86cd799439012",
        "placement": "shorts",
        "title": "Launch day",
        "visibility": "public",
        "tags": [
          "launch"
        ]
      },
      {
        "accountId": "507f1f77bcf86cd799439013",
        "tiktokPrivacyLevel": "PUBLIC_TO_EVERYONE",
        "allowComments": true,
        "allowDuet": false,
        "allowStitch": false,
        "commercialContent": false,
        "brandedContent": false,
        "promoteBrand": false,
        "aiContent": false,
        "tiktokConsent": {
          "contentSharingConfirmed": true,
          "musicUsageConfirmed": true
        }
      }
    ]
  }'

Response · 201 Created

{
  "id": "6650f1c2a4b3c2d1e0f98766",
  "kind": "video",
  "caption": "Launch day!",
  "status": "scheduled",
  "scheduledAt": "2027-06-01T09:00:00.000Z",
  "timezone": "Europe/Berlin",
  "origin": "schedule",
  "workflowId": "6650f1c2a4b3c2d1e0f98765",
  "videoAssetId": "6650f1c2a4b3c2d1e0f98765",
  "thumbnailAssetId": "6650f1c2a4b3c2d1e0f98766",
  "imageAssetIds": [
    "6650f1c2a4b3c2d1e0f98768"
  ],
  "thumbnailUrl": "https://example.com/media/launch.mp4",
  "editable": true,
  "destinations": [
    {
      "id": "6650f1c2a4b3c2d1e0f98766",
      "accountId": "6650f1c2a4b3c2d1e0f98767",
      "accountName": "My brand",
      "platform": "instagram",
      "placement": "string",
      "status": "scheduled",
      "url": "https://example.com/media/launch.mp4",
      "publishedAt": "2027-06-01T09:00:00.000Z",
      "providerPostIds": [
        "6650f1c2a4b3c2d1e0f98766"
      ],
      "error": {
        "code": "string",
        "message": "Human-readable explanation."
      },
      "metrics": {
        "views": 1840,
        "likes": 132,
        "comments": 18,
        "observedAt": "2027-06-01T09:00:00.000Z"
      },
      "options": {
        "caption": "Launch day!",
        "title": "Launch day",
        "description": "string",
        "visibility": "public",
        "tags": [
          "string"
        ],
        "categoryId": "6650f1c2a4b3c2d1e0f98768",
        "selfDeclaredMadeForKids": true,
        "containsSyntheticMedia": true,
        "notifySubscribers": true,
        "shareToFeed": true,
        "thumbOffsetMs": 0,
        "altText": "string",
        "aiGenerated": true,
        "replyControl": "everyone",
        "topicTag": "string",
        "tiktokPrivacyLevel": "PUBLIC_TO_EVERYONE",
        "allowComments": true,
        "allowDuet": true,
        "allowStitch": true,
        "commercialContent": true,
        "brandedContent": true,
        "promoteBrand": true,
        "aiContent": true,
        "tiktokPhotoTitle": "string",
        "tiktokAutoAddMusic": true
      }
    }
  ]
}

Posts paused past their scheduled time (for example after a plan lapse or a disconnected account). Resolve them with POST /posts/late/resolve.

Parameters

NameInDescription
limit integerOptionalqueryItems per page (1–100, default 20). - Range 1–100
cursor stringOptionalqueryOpaque nextCursor from the previous page. - Length 1–512 chars

Errors

Request

curl 'https://api.repostly.app/v1/posts/late' \
  -H "Authorization: Bearer $REPOSTLY_API_KEY"

Response · 200 OK

{
  "data": [
    {
      "id": "6650f1c2a4b3c2d1e0f98766",
      "kind": "video",
      "caption": "Launch day!",
      "status": "scheduled",
      "scheduledAt": "2027-06-01T09:00:00.000Z",
      "timezone": "Europe/Berlin",
      "origin": "schedule",
      "workflowId": "6650f1c2a4b3c2d1e0f98765",
      "videoAssetId": "6650f1c2a4b3c2d1e0f98765",
      "thumbnailAssetId": "6650f1c2a4b3c2d1e0f98766",
      "imageAssetIds": [
        "6650f1c2a4b3c2d1e0f98768"
      ],
      "thumbnailUrl": "https://example.com/media/launch.mp4",
      "editable": true,
      "destinations": [
        {
          "id": "6650f1c2a4b3c2d1e0f98766",
          "accountId": "6650f1c2a4b3c2d1e0f98767",
          "accountName": "My brand",
          "platform": "instagram",
          "placement": "string",
          "status": "scheduled",
          "url": "https://example.com/media/launch.mp4",
          "publishedAt": "2027-06-01T09:00:00.000Z",
          "providerPostIds": [
            "6650f1c2a4b3c2d1e0f98766"
          ],
          "error": {
            "code": "string",
            "message": "Human-readable explanation."
          },
          "metrics": {
            "views": 1840,
            "likes": 132,
            "comments": 18,
            "observedAt": "2027-06-01T09:00:00.000Z"
          },
          "options": {
            "caption": "Launch day!",
            "title": "Launch day",
            "description": "string",
            "visibility": "public",
            "tags": [
              "string"
            ],
            "categoryId": "6650f1c2a4b3c2d1e0f98768",
            "selfDeclaredMadeForKids": true,
            "containsSyntheticMedia": true,
            "notifySubscribers": true,
            "shareToFeed": true,
            "thumbOffsetMs": 0,
            "altText": "string",
            "aiGenerated": true,
            "replyControl": "everyone",
            "topicTag": "string",
            "tiktokPrivacyLevel": "PUBLIC_TO_EVERYONE",
            "allowComments": true,
            "allowDuet": true,
            "allowStitch": true,
            "commercialContent": true,
            "brandedContent": true,
            "promoteBrand": true,
            "aiContent": true,
            "tiktokPhotoTitle": "string",
            "tiktokAutoAddMusic": true
          }
        }
      ]
    }
  ],
  "nextCursor": "eyJwYWdlIjoyfQ"
}

Resolves up to 100 late posts at once. publish queues them now; reschedule spaces them from startAt by spacingMinutes; discard cancels them. Each post is reported as resolved or skipped (with a reason). Requires an Idempotency-Key: retry with the same key and body after a timeout; the original result is replayed (Idempotency-Replayed: true, with its Retry-After). Keys are remembered for 30 days. Non-final outcomes are not saved: errors returned before any change was made, every 429 and transient capacity or state conflicts (such as 409 POST_BUSY); retry those with the same key after Retry-After.

Parameters

NameInDescription
Idempotency-Key stringRequiredheaderUnique per logical action. Retry with the same key and body after a timeout; remembered for 30 days. - Length 8–128 chars - Pattern ^[A-Za-z0-9_.:-]{8,128}$

Request body application/json

NameDescription
action stringRequiredpublish now, reschedule from startAt, or discard (cancel). - One of publish reschedule discard
postIds string[]Required- Items 1–100 items - Unique items
startAt string (date-time) | integerOptionalreschedule: the first new publishing time (must not be in the past). ISO 8601 date-time with offset or Unix milliseconds.
spacingMinutes integerOptionalreschedule: minutes between consecutive posts. - Default 15 - Range 0–240

Errors

Request

curl -X POST 'https://api.repostly.app/v1/posts/late/resolve' \
  -H "Authorization: Bearer $REPOSTLY_API_KEY" \
  -H 'Idempotency-Key: resolveLatePosts-0001' \
  -H 'Content-Type: application/json' \
  -d '{
    "action": "reschedule",
    "postIds": [
      "507f1f77bcf86cd799439011"
    ],
    "startAt": "2027-06-02T09:00:00Z",
    "spacingMinutes": 30
  }'

Response · 200 OK

{
  "resolved": [
    {
      "postId": "6650f1c2a4b3c2d1e0f98768",
      "scheduledAt": "2027-06-01T09:00:00.000Z"
    }
  ],
  "skipped": [
    {
      "postId": "6650f1c2a4b3c2d1e0f98768",
      "reason": "string"
    }
  ]
}

One post and its destinations. For editable posts each destination includes options in the form PUT /posts/{id} accepts, so you can GET, modify and PUT.

Parameters

NameInDescription
id stringRequiredpathPost ID. Posts imported from a connected account use the form imported:<id>. - Pattern ^(imported:)?[a-fA-F0-9]{24}$

Errors

Request

curl 'https://api.repostly.app/v1/posts/6650f1c2a4b3c2d1e0f98766' \
  -H "Authorization: Bearer $REPOSTLY_API_KEY"

Response · 200 OK

{
  "id": "6650f1c2a4b3c2d1e0f98766",
  "kind": "video",
  "caption": "Launch day!",
  "status": "scheduled",
  "scheduledAt": "2027-06-01T09:00:00.000Z",
  "timezone": "Europe/Berlin",
  "origin": "schedule",
  "workflowId": "6650f1c2a4b3c2d1e0f98765",
  "videoAssetId": "6650f1c2a4b3c2d1e0f98765",
  "thumbnailAssetId": "6650f1c2a4b3c2d1e0f98766",
  "imageAssetIds": [
    "6650f1c2a4b3c2d1e0f98768"
  ],
  "thumbnailUrl": "https://example.com/media/launch.mp4",
  "editable": true,
  "destinations": [
    {
      "id": "6650f1c2a4b3c2d1e0f98766",
      "accountId": "6650f1c2a4b3c2d1e0f98767",
      "accountName": "My brand",
      "platform": "instagram",
      "placement": "string",
      "status": "scheduled",
      "url": "https://example.com/media/launch.mp4",
      "publishedAt": "2027-06-01T09:00:00.000Z",
      "providerPostIds": [
        "6650f1c2a4b3c2d1e0f98766"
      ],
      "error": {
        "code": "string",
        "message": "Human-readable explanation."
      },
      "metrics": {
        "views": 1840,
        "likes": 132,
        "comments": 18,
        "observedAt": "2027-06-01T09:00:00.000Z"
      },
      "options": {
        "caption": "Launch day!",
        "title": "Launch day",
        "description": "string",
        "visibility": "public",
        "tags": [
          "string"
        ],
        "categoryId": "6650f1c2a4b3c2d1e0f98768",
        "selfDeclaredMadeForKids": true,
        "containsSyntheticMedia": true,
        "notifySubscribers": true,
        "shareToFeed": true,
        "thumbOffsetMs": 0,
        "altText": "string",
        "aiGenerated": true,
        "replyControl": "everyone",
        "topicTag": "string",
        "tiktokPrivacyLevel": "PUBLIC_TO_EVERYONE",
        "allowComments": true,
        "allowDuet": true,
        "allowStitch": true,
        "commercialContent": true,
        "brandedContent": true,
        "promoteBrand": true,
        "aiContent": true,
        "tiktokPhotoTitle": "string",
        "tiktokAutoAddMusic": true
      }
    }
  ]
}

Full replacement (same body as create) of a post that has not started publishing; omitting scheduledAt keeps the post's current scheduled time. Returns 409 once publishing started and for workflow posts (409 POST_BUSY while the scheduler or another change holds the post: retry shortly). The content kind cannot change. Keeping the same videoAssetId keeps its prepared audio. An Idempotency-Key is optional and honored when sent. Non-final outcomes are not saved: errors returned before any change was made, every 429 and transient capacity or state conflicts (such as 409 POST_BUSY); retry those with the same key after Retry-After.

Parameters

NameInDescription
id stringRequiredpath24-character hexadecimal ID. - Pattern ^[a-fA-F0-9]{24}$
Idempotency-Key stringOptionalheaderOptional. When sent, retries with the same key and input replay the first result. - Length 8–128 chars - Pattern ^[A-Za-z0-9_.:-]{8,128}$

Request body application/json

NameDescription
caption stringOptionalShared caption. Required for text posts. - Length ≤ 4000 chars
scheduledAt string (date-time) | integerOptionalWhen to publish. On create, omit it (or send a time up to 60 s in the past) to publish on the next scheduler run. On replace (PUT), omit it to keep the post's current scheduled time. ISO 8601 date-time with offset or Unix milliseconds.
timezone stringOptionalIANA time zone for display and email context (default UTC). It never reinterprets scheduledAt. - Length 1–64 chars
videoAssetId stringOptionalUploaded video asset (makes this a video post). - Pattern ^[a-fA-F0-9]{24}$
thumbnailAssetId stringOptionalOptional uploaded image asset used as the video thumbnail. - Pattern ^[a-fA-F0-9]{24}$
imageAssetIds string[]OptionalUploaded image assets: one → image post, 2–20 → carousel. - Items ≤ 20 items - Unique items
destinations object[]Required- Items 1–50 items
destinations[].accountId stringRequiredConnected account ID from GET /accounts. - Pattern ^[a-fA-F0-9]{24}$
destinations[].placement stringOptionalWhere the content appears. Defaults: video posts → youtube video, instagram reels, facebook video, threads video, tiktok video; image → image; carousel → carousel; text → text. - One of video shorts reels image carousel text
destinations[].caption stringOptionalCaption for this destination only (overrides the post caption). - Length ≤ 4000 chars
destinations[].title stringOptionalYouTube: the video title, at most 100 characters without < or > (YouTube uses the caption as title). Facebook video: the video title (at most 200). - Length ≤ 200 chars
destinations[].description stringOptionalYouTube and Facebook video description. - Length ≤ 5000 chars
destinations[].visibility stringOptionalYouTube video visibility. Default public. - One of public unlisted private
destinations[].tags string[]OptionalYouTube tags. - Items ≤ 100 items
destinations[].categoryId stringOptionalYouTube category ID. - Length ≤ 3 chars
destinations[].selfDeclaredMadeForKids booleanOptionalYouTube: made for kids.
destinations[].containsSyntheticMedia booleanOptionalYouTube: altered or synthetic content disclosure.
destinations[].notifySubscribers booleanOptionalYouTube: notify subscribers.
destinations[].shareToFeed booleanOptionalInstagram Reels: also share to the feed.
destinations[].thumbOffsetMs integerOptionalInstagram Reels: cover frame offset in milliseconds. - Range 0–86400000
destinations[].altText stringOptionalImage alt text (Instagram, Facebook, Threads). - Length ≤ 1000 chars
destinations[].aiGenerated booleanOptionalInstagram / Facebook Reels: AI-generated label.
destinations[].replyControl stringOptionalThreads reply control. - One of everyone accounts_you_follow mentioned_only parent_post_author_only followers_only
destinations[].topicTag stringOptionalThreads topic tag. - Length ≤ 50 chars
destinations[].tiktokPrivacyLevel stringOptionalTikTok privacy level; must be one of privacyLevelOptions from tiktok-creator-info. - One of PUBLIC_TO_EVERYONE MUTUAL_FOLLOW_FRIENDS FOLLOWER_OF_CREATOR SELF_ONLY
destinations[].allowComments booleanOptionalTikTok: allow comments (explicit choice required).
destinations[].allowDuet booleanOptionalTikTok video: allow duets (explicit choice required).
destinations[].allowStitch booleanOptionalTikTok video: allow stitches (explicit choice required).
destinations[].commercialContent booleanOptionalTikTok: commercial content disclosure; true exactly when brandedContent or promoteBrand is true.
destinations[].brandedContent booleanOptionalTikTok: branded content (paid partnership).
destinations[].promoteBrand booleanOptionalTikTok: promotes your own brand.
destinations[].aiContent booleanOptionalTikTok: AI-generated content label.
destinations[].tiktokPhotoTitle stringOptionalTikTok photo posts: title (required for photo posts). - Length ≤ 90 chars
destinations[].tiktokAutoAddMusic booleanOptionalTikTok photo posts: let TikTok add music (required for photo posts).
destinations[].tiktokConsent objectOptionalExplicit TikTok creator consent collected in your UI for this post. Required for TikTok destinations on every create and every replace (PUT); GET never returns stored consent.
destinations[].tiktokConsent.contentSharingConfirmed booleanRequiredThe creator confirmed TikTok's content sharing terms.
destinations[].tiktokConsent.musicUsageConfirmed booleanRequiredThe creator confirmed TikTok's music usage confirmation.
destinations[].tiktokConsent.brandedContentPolicyConfirmed booleanOptionalRequired when brandedContent is true.

Errors

Request

curl -X PUT 'https://api.repostly.app/v1/posts/6650f1c2a4b3c2d1e0f98766' \
  -H "Authorization: Bearer $REPOSTLY_API_KEY" \
  -H 'Idempotency-Key: replacePost-0001' \
  -H 'Content-Type: application/json' \
  -d '{
    "caption": "Launch day!",
    "scheduledAt": "2027-06-01T09:00:00+02:00",
    "timezone": "Europe/Berlin",
    "videoAssetId": "64b7f0c2a1e4d3b2c1f0e9d8",
    "destinations": [
      {
        "accountId": "507f1f77bcf86cd799439011",
        "placement": "reels",
        "caption": "IG-specific caption",
        "shareToFeed": true
      },
      {
        "accountId": "507f1f77bcf86cd799439012",
        "placement": "shorts",
        "title": "Launch day",
        "visibility": "public",
        "tags": [
          "launch"
        ]
      }
    ]
  }'

Response · 200 OK

{
  "id": "6650f1c2a4b3c2d1e0f98766",
  "kind": "video",
  "caption": "Launch day!",
  "status": "scheduled",
  "scheduledAt": "2027-06-01T09:00:00.000Z",
  "timezone": "Europe/Berlin",
  "origin": "schedule",
  "workflowId": "6650f1c2a4b3c2d1e0f98765",
  "videoAssetId": "6650f1c2a4b3c2d1e0f98765",
  "thumbnailAssetId": "6650f1c2a4b3c2d1e0f98766",
  "imageAssetIds": [
    "6650f1c2a4b3c2d1e0f98768"
  ],
  "thumbnailUrl": "https://example.com/media/launch.mp4",
  "editable": true,
  "destinations": [
    {
      "id": "6650f1c2a4b3c2d1e0f98766",
      "accountId": "6650f1c2a4b3c2d1e0f98767",
      "accountName": "My brand",
      "platform": "instagram",
      "placement": "string",
      "status": "scheduled",
      "url": "https://example.com/media/launch.mp4",
      "publishedAt": "2027-06-01T09:00:00.000Z",
      "providerPostIds": [
        "6650f1c2a4b3c2d1e0f98766"
      ],
      "error": {
        "code": "string",
        "message": "Human-readable explanation."
      },
      "metrics": {
        "views": 1840,
        "likes": 132,
        "comments": 18,
        "observedAt": "2027-06-01T09:00:00.000Z"
      },
      "options": {
        "caption": "Launch day!",
        "title": "Launch day",
        "description": "string",
        "visibility": "public",
        "tags": [
          "string"
        ],
        "categoryId": "6650f1c2a4b3c2d1e0f98768",
        "selfDeclaredMadeForKids": true,
        "containsSyntheticMedia": true,
        "notifySubscribers": true,
        "shareToFeed": true,
        "thumbOffsetMs": 0,
        "altText": "string",
        "aiGenerated": true,
        "replyControl": "everyone",
        "topicTag": "string",
        "tiktokPrivacyLevel": "PUBLIC_TO_EVERYONE",
        "allowComments": true,
        "allowDuet": true,
        "allowStitch": true,
        "commercialContent": true,
        "brandedContent": true,
        "promoteBrand": true,
        "aiContent": true,
        "tiktokPhotoTitle": "string",
        "tiktokAutoAddMusic": true
      }
    }
  ]
}

Cancels a post that has not started publishing (204). Never deletes content that is already live on a platform. An Idempotency-Key is optional and honored when sent. Non-final outcomes are not saved: errors returned before any change was made, every 429 and transient capacity or state conflicts (such as 409 POST_BUSY); retry those with the same key after Retry-After.

Parameters

NameInDescription
id stringRequiredpath24-character hexadecimal ID. - Pattern ^[a-fA-F0-9]{24}$
Idempotency-Key stringOptionalheaderOptional. When sent, retries with the same key and input replay the first result. - Length 8–128 chars - Pattern ^[A-Za-z0-9_.:-]{8,128}$

Errors

Request

curl -X DELETE 'https://api.repostly.app/v1/posts/6650f1c2a4b3c2d1e0f98766' \
  -H "Authorization: Bearer $REPOSTLY_API_KEY" \
  -H 'Idempotency-Key: cancelPost-0001'

Response · 204 No Content

Empty body.

Net change in views, likes and comments per hour (24h) or day (7d, 30d), for the post and for each published destination. Values are null where no observation exists.

Parameters

NameInDescription
id stringRequiredpathPost ID. Posts imported from a connected account use the form imported:<id>. - Pattern ^(imported:)?[a-fA-F0-9]{24}$
range stringOptionalquery- One of 24h 7d 30d - Default 7d
timezone stringOptionalqueryTime zone of the range's days and hours (default UTC). - Length 1–64 chars

Errors

Request

curl 'https://api.repostly.app/v1/posts/6650f1c2a4b3c2d1e0f98766/analytics' \
  -H "Authorization: Bearer $REPOSTLY_API_KEY"

Response · 200 OK

{
  "postId": "6650f1c2a4b3c2d1e0f98768",
  "range": "string",
  "timezone": "Europe/Berlin",
  "points": [
    {
      "at": "2027-06-01T09:00:00.000Z",
      "views": 1840,
      "likes": 132,
      "comments": 18
    }
  ],
  "destinations": [
    {
      "accountId": "6650f1c2a4b3c2d1e0f98767",
      "platform": "instagram",
      "points": [
        {
          "at": "2027-06-01T09:00:00.000Z",
          "views": 1840,
          "likes": 132,
          "comments": 18
        }
      ]
    }
  ]
}

Workflows automatically repost content from a source account to a destination account.

Parameters

NameInDescription
limit integerOptionalqueryItems per page (1–100, default 20). - Range 1–100
cursor stringOptionalqueryOpaque nextCursor from the previous page. - Length 1–512 chars

Errors

Request

curl 'https://api.repostly.app/v1/workflows' \
  -H "Authorization: Bearer $REPOSTLY_API_KEY"

Response · 200 OK

{
  "data": [
    {
      "id": "6650f1c2a4b3c2d1e0f98766",
      "name": "My brand",
      "status": "active",
      "mode": "new_posts",
      "source": {
        "accountId": "6650f1c2a4b3c2d1e0f98767",
        "accountName": "My brand",
        "platform": "instagram",
        "content": "string",
        "pageId": "6650f1c2a4b3c2d1e0f98767"
      },
      "destination": {
        "accountId": "6650f1c2a4b3c2d1e0f98767",
        "accountName": "My brand",
        "platform": "instagram",
        "content": "string",
        "pageId": "6650f1c2a4b3c2d1e0f98767"
      },
      "backlog": {
        "startAt": "2027-06-01T09:00:00.000Z",
        "timezone": "Europe/Berlin",
        "order": "oldest_first",
        "postTimes": [
          "string"
        ]
      },
      "createdAt": "2027-06-01T09:00:00.000Z"
    }
  ],
  "nextCursor": "eyJwYWdlIjoyfQ"
}

Creates an active workflow. mode new_posts reposts content as it appears; backlog works through existing content at the daily postTimes. Source/destination combinations follow the app's supported matrix (422 otherwise); TikTok destinations need tiktokDeclaration: true; loops return 508. Requires an Idempotency-Key: retry with the same key and body after a timeout; the original result is replayed (Idempotency-Replayed: true, with its Retry-After). Keys are remembered for 30 days. Non-final outcomes are not saved: errors returned before any change was made, every 429 and transient capacity or state conflicts (such as 409 POST_BUSY); retry those with the same key after Retry-After.

Parameters

NameInDescription
Idempotency-Key stringRequiredheaderUnique per logical action. Retry with the same key and body after a timeout; remembered for 30 days. - Length 8–128 chars - Pattern ^[A-Za-z0-9_.:-]{8,128}$

Request body application/json

NameDescription
sourceAccountId stringRequiredAccount to repost from. - Pattern ^[a-fA-F0-9]{24}$
destinationAccountId stringRequiredAccount to publish to. - Pattern ^[a-fA-F0-9]{24}$
sourceContent stringRequiredSource content type to repost. - One of reels video videos shorts text image carousel
destinationContent stringRequiredDestination content type. - One of reels video videos shorts text image carousel
mode stringRequirednew_posts: repost new content as it appears. backlog: work through existing content on a schedule. - One of new_posts backlog
backlog objectOptionalRequired when mode is backlog.
backlog.startAt string (date-time) | integerOptionalfrom_date order: the first source post date to repost from. Ignored for oldest_first. ISO 8601 date-time with offset or Unix milliseconds.
backlog.timezone stringOptionalTime zone of postTimes (default UTC). - Length 1–64 chars
backlog.order stringOptionalDefault oldest_first. - One of oldest_first from_date
backlog.postTimes string[]RequiredDaily publishing times, 24-hour HH:mm. - Items 1–24 items - Unique items
tiktokDeclaration booleanOptionalRequired for TikTok destinations: the user confirmed the workflow publishing declaration.

Errors

Request

curl -X POST 'https://api.repostly.app/v1/workflows' \
  -H "Authorization: Bearer $REPOSTLY_API_KEY" \
  -H 'Idempotency-Key: createWorkflow-0001' \
  -H 'Content-Type: application/json' \
  -d '{
    "sourceAccountId": "507f1f77bcf86cd799439011",
    "destinationAccountId": "507f1f77bcf86cd799439012",
    "sourceContent": "reels",
    "destinationContent": "shorts",
    "mode": "backlog",
    "backlog": {
      "startAt": "2026-01-01T00:00:00Z",
      "timezone": "Europe/Berlin",
      "order": "from_date",
      "postTimes": [
        "09:00",
        "18:30"
      ]
    }
  }'

Response · 201 Created

{
  "id": "6650f1c2a4b3c2d1e0f98766",
  "name": "My brand",
  "status": "active",
  "mode": "new_posts",
  "source": {
    "accountId": "6650f1c2a4b3c2d1e0f98767",
    "accountName": "My brand",
    "platform": "instagram",
    "content": "string",
    "pageId": "6650f1c2a4b3c2d1e0f98767"
  },
  "destination": {
    "accountId": "6650f1c2a4b3c2d1e0f98767",
    "accountName": "My brand",
    "platform": "instagram",
    "content": "string",
    "pageId": "6650f1c2a4b3c2d1e0f98767"
  },
  "backlog": {
    "startAt": "2027-06-01T09:00:00.000Z",
    "timezone": "Europe/Berlin",
    "order": "oldest_first",
    "postTimes": [
      "string"
    ]
  },
  "createdAt": "2027-06-01T09:00:00.000Z"
}

One workflow's settings and status.

Parameters

NameInDescription
id stringRequiredpath24-character hexadecimal ID. - Pattern ^[a-fA-F0-9]{24}$

Errors

Request

curl 'https://api.repostly.app/v1/workflows/6650f1c2a4b3c2d1e0f98766' \
  -H "Authorization: Bearer $REPOSTLY_API_KEY"

Response · 200 OK

{
  "id": "6650f1c2a4b3c2d1e0f98766",
  "name": "My brand",
  "status": "active",
  "mode": "new_posts",
  "source": {
    "accountId": "6650f1c2a4b3c2d1e0f98767",
    "accountName": "My brand",
    "platform": "instagram",
    "content": "string",
    "pageId": "6650f1c2a4b3c2d1e0f98767"
  },
  "destination": {
    "accountId": "6650f1c2a4b3c2d1e0f98767",
    "accountName": "My brand",
    "platform": "instagram",
    "content": "string",
    "pageId": "6650f1c2a4b3c2d1e0f98767"
  },
  "backlog": {
    "startAt": "2027-06-01T09:00:00.000Z",
    "timezone": "Europe/Berlin",
    "order": "oldest_first",
    "postTimes": [
      "string"
    ]
  },
  "createdAt": "2027-06-01T09:00:00.000Z"
}

Full replacement of a workflow's settings (same body as create). As in the app, saving reactivates a paused workflow. An Idempotency-Key is optional and honored when sent. Non-final outcomes are not saved: errors returned before any change was made, every 429 and transient capacity or state conflicts (such as 409 POST_BUSY); retry those with the same key after Retry-After.

Parameters

NameInDescription
id stringRequiredpath24-character hexadecimal ID. - Pattern ^[a-fA-F0-9]{24}$
Idempotency-Key stringOptionalheaderOptional. When sent, retries with the same key and input replay the first result. - Length 8–128 chars - Pattern ^[A-Za-z0-9_.:-]{8,128}$

Request body application/json

NameDescription
sourceAccountId stringRequiredAccount to repost from. - Pattern ^[a-fA-F0-9]{24}$
destinationAccountId stringRequiredAccount to publish to. - Pattern ^[a-fA-F0-9]{24}$
sourceContent stringRequiredSource content type to repost. - One of reels video videos shorts text image carousel
destinationContent stringRequiredDestination content type. - One of reels video videos shorts text image carousel
mode stringRequirednew_posts: repost new content as it appears. backlog: work through existing content on a schedule. - One of new_posts backlog
backlog objectOptionalRequired when mode is backlog.
backlog.startAt string (date-time) | integerOptionalfrom_date order: the first source post date to repost from. Ignored for oldest_first. ISO 8601 date-time with offset or Unix milliseconds.
backlog.timezone stringOptionalTime zone of postTimes (default UTC). - Length 1–64 chars
backlog.order stringOptionalDefault oldest_first. - One of oldest_first from_date
backlog.postTimes string[]RequiredDaily publishing times, 24-hour HH:mm. - Items 1–24 items - Unique items
tiktokDeclaration booleanOptionalRequired for TikTok destinations: the user confirmed the workflow publishing declaration.

Errors

Request

curl -X PUT 'https://api.repostly.app/v1/workflows/6650f1c2a4b3c2d1e0f98766' \
  -H "Authorization: Bearer $REPOSTLY_API_KEY" \
  -H 'Idempotency-Key: replaceWorkflow-0001' \
  -H 'Content-Type: application/json' \
  -d '{
    "sourceAccountId": "507f1f77bcf86cd799439011",
    "destinationAccountId": "507f1f77bcf86cd799439012",
    "sourceContent": "reels",
    "destinationContent": "shorts",
    "mode": "new_posts"
  }'

Response · 200 OK

{
  "id": "6650f1c2a4b3c2d1e0f98766",
  "name": "My brand",
  "status": "active",
  "mode": "new_posts",
  "source": {
    "accountId": "6650f1c2a4b3c2d1e0f98767",
    "accountName": "My brand",
    "platform": "instagram",
    "content": "string",
    "pageId": "6650f1c2a4b3c2d1e0f98767"
  },
  "destination": {
    "accountId": "6650f1c2a4b3c2d1e0f98767",
    "accountName": "My brand",
    "platform": "instagram",
    "content": "string",
    "pageId": "6650f1c2a4b3c2d1e0f98767"
  },
  "backlog": {
    "startAt": "2027-06-01T09:00:00.000Z",
    "timezone": "Europe/Berlin",
    "order": "oldest_first",
    "postTimes": [
      "string"
    ]
  },
  "createdAt": "2027-06-01T09:00:00.000Z"
}

Deletes the workflow (204). Posts it already created are kept. An Idempotency-Key is optional and honored when sent. Non-final outcomes are not saved: errors returned before any change was made, every 429 and transient capacity or state conflicts (such as 409 POST_BUSY); retry those with the same key after Retry-After.

Parameters

NameInDescription
id stringRequiredpath24-character hexadecimal ID. - Pattern ^[a-fA-F0-9]{24}$
Idempotency-Key stringOptionalheaderOptional. When sent, retries with the same key and input replay the first result. - Length 8–128 chars - Pattern ^[A-Za-z0-9_.:-]{8,128}$

Errors

Request

curl -X DELETE 'https://api.repostly.app/v1/workflows/6650f1c2a4b3c2d1e0f98766' \
  -H "Authorization: Bearer $REPOSTLY_API_KEY" \
  -H 'Idempotency-Key: deleteWorkflow-0001'

Response · 204 No Content

Empty body.

Stops future processing. Content already handed to publishing is not recalled. An Idempotency-Key is optional and honored when sent. Non-final outcomes are not saved: errors returned before any change was made, every 429 and transient capacity or state conflicts (such as 409 POST_BUSY); retry those with the same key after Retry-After.

Parameters

NameInDescription
id stringRequiredpath24-character hexadecimal ID. - Pattern ^[a-fA-F0-9]{24}$
Idempotency-Key stringOptionalheaderOptional. When sent, retries with the same key and input replay the first result. - Length 8–128 chars - Pattern ^[A-Za-z0-9_.:-]{8,128}$

Errors

Request

curl -X POST 'https://api.repostly.app/v1/workflows/6650f1c2a4b3c2d1e0f98766/pause' \
  -H "Authorization: Bearer $REPOSTLY_API_KEY" \
  -H 'Idempotency-Key: pauseWorkflow-0001'

Response · 200 OK

{
  "id": "6650f1c2a4b3c2d1e0f98766",
  "name": "My brand",
  "status": "active",
  "mode": "new_posts",
  "source": {
    "accountId": "6650f1c2a4b3c2d1e0f98767",
    "accountName": "My brand",
    "platform": "instagram",
    "content": "string",
    "pageId": "6650f1c2a4b3c2d1e0f98767"
  },
  "destination": {
    "accountId": "6650f1c2a4b3c2d1e0f98767",
    "accountName": "My brand",
    "platform": "instagram",
    "content": "string",
    "pageId": "6650f1c2a4b3c2d1e0f98767"
  },
  "backlog": {
    "startAt": "2027-06-01T09:00:00.000Z",
    "timezone": "Europe/Berlin",
    "order": "oldest_first",
    "postTimes": [
      "string"
    ]
  },
  "createdAt": "2027-06-01T09:00:00.000Z"
}

Reactivates the workflow after re-checking your plan, both accounts and loops. An Idempotency-Key is optional and honored when sent. Non-final outcomes are not saved: errors returned before any change was made, every 429 and transient capacity or state conflicts (such as 409 POST_BUSY); retry those with the same key after Retry-After.

Parameters

NameInDescription
id stringRequiredpath24-character hexadecimal ID. - Pattern ^[a-fA-F0-9]{24}$
Idempotency-Key stringOptionalheaderOptional. When sent, retries with the same key and input replay the first result. - Length 8–128 chars - Pattern ^[A-Za-z0-9_.:-]{8,128}$

Errors

Request

curl -X POST 'https://api.repostly.app/v1/workflows/6650f1c2a4b3c2d1e0f98766/resume' \
  -H "Authorization: Bearer $REPOSTLY_API_KEY" \
  -H 'Idempotency-Key: resumeWorkflow-0001'

Response · 200 OK

{
  "id": "6650f1c2a4b3c2d1e0f98766",
  "name": "My brand",
  "status": "active",
  "mode": "new_posts",
  "source": {
    "accountId": "6650f1c2a4b3c2d1e0f98767",
    "accountName": "My brand",
    "platform": "instagram",
    "content": "string",
    "pageId": "6650f1c2a4b3c2d1e0f98767"
  },
  "destination": {
    "accountId": "6650f1c2a4b3c2d1e0f98767",
    "accountName": "My brand",
    "platform": "instagram",
    "content": "string",
    "pageId": "6650f1c2a4b3c2d1e0f98767"
  },
  "backlog": {
    "startAt": "2027-06-01T09:00:00.000Z",
    "timezone": "Europe/Berlin",
    "order": "oldest_first",
    "postTimes": [
      "string"
    ]
  },
  "createdAt": "2027-06-01T09:00:00.000Z"
}

Source items being processed (including blocked items, the reason and the generation needed to retry them), the posts the workflow created, and failed deliveries (failedPosts; retryable marks those that can be retried, available is false when they could not be read right now), newest first. Each list pages independently: pass processing.nextCursor as processingCursor, posts.nextCursor as postsCursor and failedPosts.nextCursor as failedPostsCursor; limit applies to each. Media preparation is automatic. Retry a blocked item with POST /workflows/{id}/preparations/{preparationId}/retry and a failed delivery with POST /workflows/{id}/posts/{postId}/retry.

Parameters

NameInDescription
id stringRequiredpath24-character hexadecimal ID. - Pattern ^[a-fA-F0-9]{24}$
limit integerOptionalqueryItems per page (1–100, default 20). - Range 1–100
processingCursor stringOptionalqueryOpaque nextCursor from the previous page. - Length 1–512 chars
postsCursor stringOptionalqueryOpaque nextCursor from the previous page. - Length 1–512 chars
failedPostsCursor stringOptionalqueryOpaque nextCursor from the previous page. - Length 1–512 chars

Errors

Request

curl 'https://api.repostly.app/v1/workflows/6650f1c2a4b3c2d1e0f98766/activity' \
  -H "Authorization: Bearer $REPOSTLY_API_KEY"

Response · 200 OK

{
  "status": "active",
  "processing": {
    "data": [
      {
        "id": "6650f1c2a4b3c2d1e0f98766",
        "state": "pending",
        "blockedReason": "string",
        "generation": 1,
        "postId": "6650f1c2a4b3c2d1e0f98768",
        "sourceCaption": "string",
        "sourcePostedAt": "2027-06-01T09:00:00.000Z",
        "updatedAt": "2027-06-01T09:00:00.000Z"
      }
    ],
    "nextCursor": "eyJwYWdlIjoyfQ"
  },
  "posts": {
    "data": [
      {
        "id": "6650f1c2a4b3c2d1e0f98766",
        "kind": "video",
        "caption": "Launch day!",
        "status": "scheduled",
        "scheduledAt": "2027-06-01T09:00:00.000Z",
        "timezone": "Europe/Berlin",
        "origin": "schedule",
        "workflowId": "6650f1c2a4b3c2d1e0f98765",
        "videoAssetId": "6650f1c2a4b3c2d1e0f98765",
        "thumbnailAssetId": "6650f1c2a4b3c2d1e0f98766",
        "imageAssetIds": [
          "6650f1c2a4b3c2d1e0f98768"
        ],
        "thumbnailUrl": "https://example.com/media/launch.mp4",
        "editable": true,
        "destinations": [
          {
            "id": "6650f1c2a4b3c2d1e0f98766",
            "accountId": "6650f1c2a4b3c2d1e0f98767",
            "accountName": "My brand",
            "platform": "instagram",
            "placement": "string",
            "status": "scheduled",
            "url": "https://example.com/media/launch.mp4",
            "publishedAt": "2027-06-01T09:00:00.000Z",
            "providerPostIds": [
              "6650f1c2a4b3c2d1e0f98766"
            ],
            "error": {
              "code": "string",
              "message": "Human-readable explanation."
            },
            "metrics": {
              "views": 1840,
              "likes": 132,
              "comments": 18,
              "observedAt": "2027-06-01T09:00:00.000Z"
            },
            "options": {
              "caption": "Launch day!",
              "title": "Launch day",
              "description": "string",
              "visibility": "public",
              "tags": [
                "string"
              ],
              "categoryId": "6650f1c2a4b3c2d1e0f98768",
              "selfDeclaredMadeForKids": true,
              "containsSyntheticMedia": true,
              "notifySubscribers": true,
              "shareToFeed": true,
              "thumbOffsetMs": 0,
              "altText": "string",
              "aiGenerated": true,
              "replyControl": "everyone",
              "topicTag": "string",
              "tiktokPrivacyLevel": "PUBLIC_TO_EVERYONE",
              "allowComments": true,
              "allowDuet": true,
              "allowStitch": true,
              "commercialContent": true,
              "brandedContent": true,
              "promoteBrand": true,
              "aiContent": true,
              "tiktokPhotoTitle": "string",
              "tiktokAutoAddMusic": true
            }
          }
        ]
      }
    ],
    "nextCursor": "eyJwYWdlIjoyfQ"
  },
  "failedPosts": {
    "data": [
      {
        "id": "6650f1c2a4b3c2d1e0f98766",
        "status": "failed",
        "accountId": "6650f1c2a4b3c2d1e0f98767",
        "platform": "instagram",
        "placement": "string",
        "caption": "Launch day!",
        "failedAt": "2027-06-01T09:00:00.000Z",
        "retryable": true
      }
    ],
    "nextCursor": "eyJwYWdlIjoyfQ",
    "available": true
  }
}

Retries a processing item in state blocked (from GET /workflows/{id}/activity) with the generation shown there: it returns to pending (202) and is prepared again. Fix the cause first when blockedReason names an account or plan problem. 409 WORKFLOW_PREPARATION_CONFLICT: the item is no longer blocked or its generation changed (read the activity again). 409 WORKFLOW_UNAVAILABLE: the workflow is paused or an account is not active. 409 WORKFLOW_CHANGED, WORKFLOW_LOOP or WORKFLOW_RECONCILIATION_REQUIRED: this item cannot be retried now. 503 WORKFLOW_PREPARATION_DISABLED: retries are not available on this server. Errors change nothing, so they are not saved for the Idempotency-Key. An Idempotency-Key is optional and honored when sent. Non-final outcomes are not saved: errors returned before any change was made, every 429 and transient capacity or state conflicts (such as 409 POST_BUSY); retry those with the same key after Retry-After.

Parameters

NameInDescription
id stringRequiredpath24-character hexadecimal ID. - Pattern ^[a-fA-F0-9]{24}$
preparationId stringRequiredpathprocessing.data[].id from GET /workflows/{id}/activity. - Pattern ^[a-fA-F0-9]{24}$
Idempotency-Key stringOptionalheaderOptional. When sent, retries with the same key and input replay the first result. - Length 8–128 chars - Pattern ^[A-Za-z0-9_.:-]{8,128}$

Request body application/json

NameDescription
generation integerRequiredThe item's generation from GET /workflows/{id}/activity; a stale value returns 409. - Range 0–9007199254740991

Errors

Request

curl -X POST 'https://api.repostly.app/v1/workflows/6650f1c2a4b3c2d1e0f98766/preparations/6650f1c2a4b3c2d1e0f98767/retry' \
  -H "Authorization: Bearer $REPOSTLY_API_KEY" \
  -H 'Idempotency-Key: retryWorkflowPreparation-0001' \
  -H 'Content-Type: application/json' \
  -d '{
    "generation": 1
  }'

Response · 200 OK

{
  "id": "6650f1c2a4b3c2d1e0f98766",
  "state": "pending",
  "blockedReason": "string",
  "generation": 1,
  "postId": "6650f1c2a4b3c2d1e0f98768",
  "sourceCaption": "string",
  "sourcePostedAt": "2027-06-01T09:00:00.000Z",
  "updatedAt": "2027-06-01T09:00:00.000Z"
}

Queues a failed delivery from failedPosts of GET /workflows/{id}/activity again, as the retry on the app's workflow page does: the same source content is published to the workflow's destination (status processing). Watch the activity; a delivery that fails again reappears in failedPosts. Only entries with retryable true can be retried. 404 WORKFLOW_POST_NOT_FOUND: not a delivery of this workflow. 409 WORKFLOW_POST_NOT_RETRYABLE: it is not failed (already retried). 409 WORKFLOW_UNAVAILABLE: the workflow is paused; resume it first. 409 WORKFLOW_POST_DESTINATION_CHANGED: the workflow now publishes to a different account, so this delivery cannot be retried. 409 WORKFLOW_ACCOUNT_UNAVAILABLE: an account is disconnected, needs reconnecting, or is halted by the plan's account allowance. An Idempotency-Key is optional and honored when sent. Non-final outcomes are not saved: errors returned before any change was made, every 429 and transient capacity or state conflicts (such as 409 POST_BUSY); retry those with the same key after Retry-After.

Parameters

NameInDescription
id stringRequiredpath24-character hexadecimal ID. - Pattern ^[a-fA-F0-9]{24}$
postId stringRequiredpathfailedPosts.data[].id from GET /workflows/{id}/activity. - Pattern ^[a-fA-F0-9]{24}$
Idempotency-Key stringOptionalheaderOptional. When sent, retries with the same key and input replay the first result. - Length 8–128 chars - Pattern ^[A-Za-z0-9_.:-]{8,128}$

Errors

Request

curl -X POST 'https://api.repostly.app/v1/workflows/6650f1c2a4b3c2d1e0f98766/posts/6650f1c2a4b3c2d1e0f98768/retry' \
  -H "Authorization: Bearer $REPOSTLY_API_KEY" \
  -H 'Idempotency-Key: retryWorkflowPost-0001'

Response · 202 Accepted

{
  "id": "6650f1c2a4b3c2d1e0f98766",
  "status": "failed",
  "accountId": "6650f1c2a4b3c2d1e0f98767",
  "platform": "instagram",
  "placement": "string",
  "caption": "Launch day!",
  "failedAt": "2027-06-01T09:00:00.000Z",
  "retryable": true
}

Views, likes, comments, follower change and posts in the range, with the change against the previous range (null without a baseline) and lifetime totals. Stored observations, not a live platform refresh; may lag up to about an hour.

Parameters

NameInDescription
range stringOptionalqueryTime window ending now. - One of 24h 7d 30d 365d all - Default 30d
accountId stringOptionalqueryOnly this connected account. - Pattern ^[a-fA-F0-9]{24}$
platform stringOptionalqueryOnly this platform. - One of instagram facebook tiktok youtube threads
timezone stringOptionalqueryTime zone of the range's days and hours (default UTC). - Length 1–64 chars

Errors

Request

curl 'https://api.repostly.app/v1/analytics/summary' \
  -H "Authorization: Bearer $REPOSTLY_API_KEY"

Response · 200 OK

{
  "range": "string",
  "valueKind": "string",
  "totals": {
    "views": 1840,
    "likes": 132,
    "comments": 18,
    "followers": 5210,
    "posts": 12
  },
  "changePercent": {
    "views": 1840,
    "likes": 132,
    "comments": 18,
    "followers": 5210,
    "posts": 12
  },
  "lifetime": {
    "views": 1840,
    "likes": 132,
    "comments": 18,
    "posts": 12
  }
}

Hourly (24h), daily (7d, 30d, 365d) or weekly (all, Monday-based) points of the observed change in one metric. Buckets start on hour/day/week boundaries in timezone: endAt (default now, at most one day ahead) is aligned down to the start of its bucket, and the last point is that (possibly partial) bucket. Stored observations; may lag up to about an hour.

Parameters

NameInDescription
metric stringRequiredquery- One of views likes comments followers
range stringOptionalqueryTime window ending now. - One of 24h 7d 30d 365d all - Default 30d
accountId stringOptionalqueryOnly this connected account. - Pattern ^[a-fA-F0-9]{24}$
platform stringOptionalqueryOnly this platform. - One of instagram facebook tiktok youtube threads
timezone stringOptionalqueryBucket boundaries' time zone (default UTC). - Length 1–64 chars
endAt string (date-time) | integerOptionalqueryAny time within the last bucket (default now); aligned down to its bucket start. ISO 8601 date-time with offset or Unix milliseconds.

Errors

Request

curl 'https://api.repostly.app/v1/analytics/timeseries?metric=views' \
  -H "Authorization: Bearer $REPOSTLY_API_KEY"

Response · 200 OK

{
  "metric": "string",
  "range": "string",
  "timezone": "Europe/Berlin",
  "points": [
    {
      "at": "2027-06-01T09:00:00.000Z",
      "value": 1840,
      "increase": 1,
      "decrease": 1,
      "baseline": 1
    }
  ],
  "coverage": {
    "latestObservedAt": "2027-06-01T09:00:00.000Z"
  }
}

Posts ranked by observed view growth in the range. postId is the same ID as in /posts.

Parameters

NameInDescription
range stringOptionalquery- One of 24h 7d 30d - Default 7d
accountId stringOptionalqueryOnly this connected account. - Pattern ^[a-fA-F0-9]{24}$
platform stringOptionalqueryOnly this platform. - One of instagram facebook tiktok youtube threads
timezone stringOptionalqueryTime zone of the range's days and hours (default UTC). - Length 1–64 chars

Errors

Request

curl 'https://api.repostly.app/v1/analytics/top-posts' \
  -H "Authorization: Bearer $REPOSTLY_API_KEY"

Response · 200 OK

{
  "range": "string",
  "valueKind": "string",
  "data": [
    {
      "postId": "6650f1c2a4b3c2d1e0f98768",
      "caption": "Launch day!",
      "thumbnailUrl": "https://example.com/media/launch.mp4",
      "netViews": 1,
      "destinations": [
        {
          "accountId": "6650f1c2a4b3c2d1e0f98767",
          "accountName": "My brand",
          "platform": "instagram",
          "netViews": 1,
          "lastCheckedAt": "2027-06-01T09:00:00.000Z"
        }
      ]
    }
  ]
}

Observed view growth across your accounts grouped by the local hour (0–23) in which it was recorded. Each reading uses the requested time zone's offset on its own date, including daylight saving time. It shows when your audience watches, which you can use to choose posting times; it is not grouped by when posts were published. Baseline readings are excluded.

Parameters

NameInDescription
range stringOptionalqueryTime window ending now. - One of 24h 7d 30d 365d all - Default 30d
accountId stringOptionalqueryOnly this connected account. - Pattern ^[a-fA-F0-9]{24}$
platform stringOptionalqueryOnly this platform. - One of instagram facebook tiktok youtube threads
timezone stringOptionalqueryTime zone of the hours (default UTC). - Length 1–64 chars

Errors

Request

curl 'https://api.repostly.app/v1/analytics/best-times' \
  -H "Authorization: Bearer $REPOSTLY_API_KEY"

Response · 200 OK

{
  "range": "string",
  "timezone": "Europe/Berlin",
  "hours": [
    {
      "hour": 9,
      "value": 1840
    }
  ]
}