Repostly
Lên lịch đăng video ngắn lên TikTok, Instagram, YouTube, Facebook và Threads, đồng thời xem số liệu phân tích bài đăng.
Máy chủ MCP được lưu trữ
npx add-mcp 'https://server.repostly.app/mcp'Cài vào Claude Code, Codex, Cursor và nhiều công cụ khác
Tài liệu
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.
-
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. ShellCopyexport REPOSTLY_API_KEY='rp_live_…' -
Check the key
GET /meconfirms your plan, the key's scopes and your rate limits. ShellCopy
Response (abridged)Copycurl https://api.repostly.app/v1/me \ -H "Authorization: Bearer $REPOSTLY_API_KEY"{ "plan": "pro", "key": { "name": "Zapier", "scopes": ["accounts:read", "assets:write", "posts:write"] }, "rateLimits": { "windowSeconds": 60, "total": 300, "writes": 60 } } -
Pick a destination
Each connected social account has an ID. Connect accounts in the app first. A key withaccounts:writecan also disconnect one with DELETE/accounts/{id}, which removes the account's workflows and stored data too. ShellCopycurl https://api.repostly.app/v1/accounts \ -H "Authorization: Bearer $REPOSTLY_API_KEY" # → { "data": [{ "id": "6650f1c2a4b3c2d1e0f98765", "platform": "instagram", ... }] } -
Upload a video
Send the file as multipart fieldfile(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,PUTthe file to its URL, then complete it. ShellCopycurl -X POST https://api.repostly.app/v1/assets \ -H "Authorization: Bearer $REPOSTLY_API_KEY" \ -F 'file=@launch.mp4' # → { "id": "6650f1c2a4b3c2d1e0f98766", "kind": "video", ... } -
Create the post
Leave outscheduledAtto publish on the next scheduler run. The placement defaults per platform (Instagram → Reels). ShellCopycurl -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" }] }' -
Track it
Poll the post. Each destination reports its own status and, once live, its URL. ShellCopycurl 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 /mereturns403 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.
| Permission | What it allows |
|---|---|
accounts:read | View connected social accounts and publishing options |
accounts:write | Disconnect connected social accounts |
posts:read | View posts, schedules and publishing status |
posts:write | Create, publish, edit and cancel posts |
workflows:read | View reposting workflows and their activity |
workflows:write | Create, change, pause and delete reposting workflows |
assets:read | View uploaded media |
assets:write | Upload media and manage pending uploads |
analytics:read | Read 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.
| Area | Tools | Use |
|---|---|---|
| Account & capabilities | getMe getPublishingCapabilities | Plan, approved permissions, expiry and rate limits; supported content kinds, placements and workflow types. |
| Accounts | listAccounts getAccount getTiktokCreatorInfo disconnectAccount | Find connected accounts, read TikTok creator options, disconnect an account (needs accounts:write). |
| Media & uploads | listAssets getAsset createUpload completeUpload getUpload cancelUpload | Reuse library media or upload a new file with the direct-upload flow. |
| Posts | listPosts getPost createPost replacePost cancelPost getPostAnalytics | Schedule one post to several accounts, check each destination, edit or cancel pending posts. |
| Late posts | listLatePosts resolveLatePosts | Find posts paused past their time; publish, reschedule or discard selected ones. |
| Workflows | listWorkflows getWorkflow createWorkflow replaceWorkflow deleteWorkflow pauseWorkflow resumeWorkflow getWorkflowActivity retryWorkflowPreparation retryWorkflowPost | Manage repost automations, inspect blocked and failed items, retry them. |
| Analytics | getAnalyticsSummary getAnalyticsTimeseries getTopPosts getBestPostingTimes | Totals, 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 withPUTtoupload.urlusing exactlyupload.headers(for examplecurl -T FILE), then callcompleteUploadand pollgetUploaduntil 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
scheduledAtpublishes 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
| Symptom | What to do |
|---|---|
| Sign-in loops or the assistant says it is not connected | Revoke the connection under AI assistants in the app, remove the connector in the assistant and connect again. |
| INSUFFICIENT_SCOPE, or a tool is refused | The connection lacks that permission. Reconnect and approve it (for example posts:write), then ask again. |
| PLAN_REQUIRED | Everything except reading the account needs an active Starter, Pro or Expert plan. |
| 429 or rate limit | Wait for Retry-After seconds. Assistants share your plan’s API limits. |
| Unknown OAuth client, or the connection is not recognised | Remove the Repostly connector in your assistant and add it again. |
| Connection expired | Connections 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 /meworks; everything else returns403 PLAN_REQUIREDwith 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 /mereturnskey.expiresAt(nullwhen 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.
| Scope | Allows |
|---|---|
accounts:read | List connected accounts and read TikTok creator info |
accounts:write | Disconnect connected social accounts (also deletes the account's workflows and stored data) |
assets:read | List and read uploaded media |
assets:write | Upload media |
posts:read | List and read posts, including late posts |
posts:write | Create, replace and cancel posts; resolve late posts |
workflows:read | List workflows and read their activity |
workflows:write | Create, replace, pause, resume, delete and retry workflows |
analytics:read | Account 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).
- POST
/uploadswithcontentType, the exactsizeBytesand an optionalfileName. It needs anIdempotency-Keyand returns anuploadobject with a URL that works for one hour. PUTthe file bytes toupload.urlwith exactlyupload.headers. Don't send your API key there. A different content type or size is rejected by storage.- POST
/uploads/{id}/completereturns202while the file is checked.409 UPLOAD_NOT_RECEIVEDmeans the file hasn't arrived yet: retry thePUTif it failed, then complete again. - Poll GET
/uploads/{id}every few seconds untilstatusisready(withassetIdandasset) orfailed(witherror.codeand a message, for exampleUNSUPPORTED_MEDIAorUPLOAD_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_UNAVAILABLEmeans 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
429withRetry-After.
Content kind is inferred
| You send | Kind |
|---|---|
videoAssetId | video |
imageAssetIds with 1 ID | image |
imageAssetIds with 2–20 IDs | carousel |
| No asset | text |
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).
| Platform | Video | Image | Carousel | Text |
|---|---|---|---|---|
| YouTube | video shorts | — | — | — |
reels | image | carousel | — | |
video reels | image | carousel | — | |
| Threads | video | image | carousel | text |
| TikTok | video | image | carousel | — |
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 }
}
]
}
scheduledAtis optional. Leave it out to publish on the next scheduler run. More than 60 seconds in the past returns400 SCHEDULE_IN_PAST.timezone(defaultUTC) is display context only. It never shiftsscheduledAt.- PUT
/posts/{id}replaces a pending post with a full body. Read GET/posts/{id}, change it, send it back (for TikTok destinations add freshtiktokConsent; it is never returned). Once processing starts it returns409. - 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:
| Platform | Options |
|---|---|
| All | caption (overrides the post caption) |
| YouTube | title description tags categoryId visibility notifySubscribers selfDeclaredMadeForKids containsSyntheticMedia |
shareToFeed thumbOffsetMs altText aiGenerated | |
title description altText aiGenerated | |
| Threads | replyControl topicTag altText |
| TikTok | tiktokPrivacyLevel 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
- Call GET
/accounts/{id}/tiktok-creator-inforight before you show the publish form. - Show the creator the privacy levels, interaction settings and maximum duration it returns, plus a preview of the content.
- Send their explicit choices:
tiktokPrivacyLevel,allowComments/allowDuet/allowStitch, disclosure flags andtiktokConsent. Collect consent again for every create and everyPUT: 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"]
}
}
| Field | Values |
|---|---|
mode | new_posts reposts what's published from now on. backlog works through older posts and needs backlog. |
sourceContent, destinationContent | reels, video, videos, shorts, text, image, carousel |
backlog.order | oldest_first (default) or from_date, which starts at backlog.startAt |
backlog.postTimes | 1–24 unique 24-hour times, such as "09:00", in backlog.timezone |
tiktokDeclaration | Required when the destination is TikTok |
Run and inspect
- POST
/workflows/{id}/pauseand POST/workflows/{id}/resumestop 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}/activityreturns items being processed (with ablockedReasonwhen stuck), the posts the workflow created and failed deliveries (failedPosts). Each processing item has ageneration. The three lists page separately withprocessingCursor,postsCursorandfailedPostsCursor. If the failed list cannot be read, it comes back empty withavailable: falseinstead of failing the whole response. - POST
/workflows/{id}/preparations/{preparationId}/retryretries a blocked item with thegenerationshown in the activity. POST/workflows/{id}/posts/{postId}/retryqueues a failed delivery again when itsretryableflag is true. Retries need an active workflow with connected accounts; otherwise they return409(WORKFLOW_UNAVAILABLE,WORKFLOW_ACCOUNT_UNAVAILABLE,WORKFLOW_POST_DESTINATION_CHANGED) and change nothing. - DELETE
/workflows/{id}returns204. Content already published stays live.
Unsupported routes and loops are rejected; a loop returns 508. You need the rights to repost the source content.
| Endpoint | Returns |
|---|---|
GET /analytics/summary | Totals for views, likes, comments, followers and posts, with change vs. the previous period |
GET /analytics/timeseries | One 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-posts | Best-performing posts, with the same IDs as /posts |
GET /analytics/best-times | Audience 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}/analytics | Engagement 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
changePercentisnullwhen 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
| Inputs | ISO 8601 with an offset or Z (2027-06-01T10:00:00+02:00), or Unix milliseconds (1811836800000) |
|---|---|
| Outputs | Always ISO 8601 in UTC: 2027-06-01T08:00:00.000Z |
timezone | An 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" }]
}
}
}
| Status | Code | Meaning |
|---|---|---|
| 400 | INVALID_REQUEST UNKNOWN_FIELD | A field is missing, malformed or not part of the schema. See details.fields. |
| 400 | INVALID_CURSOR SCHEDULE_IN_PAST IDEMPOTENCY_KEY_REQUIRED | Bad cursor, a time too far in the past, or a missing Idempotency-Key. |
| 401 | INVALID_API_KEY | Key missing, invalid, expired or revoked. |
| 403 | PLAN_REQUIRED INSUFFICIENT_SCOPE | No paid plan, or the key lacks the scope. |
| 404 | ACCOUNT_NOT_FOUND WORKFLOW_NOT_FOUND WORKFLOW_PREPARATION_NOT_FOUND WORKFLOW_POST_NOT_FOUND | The 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. |
| 409 | IDEMPOTENCY_CONFLICT REQUEST_UNCONFIRMED | Key reused with different input, or an earlier attempt is unconfirmed. Also returned when a post is already processing. |
| 409 | TOO_MANY_UPLOADS UPLOAD_NOT_RECEIVED | Direct uploads: 3 already running, or complete was called before the file arrived (retry the PUT, then complete). |
| 409 | WORKFLOW_UNAVAILABLE WORKFLOW_ACCOUNT_UNAVAILABLE | Workflow 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. |
| 409 | WORKFLOW_POST_NOT_RETRYABLE WORKFLOW_POST_DESTINATION_CHANGED | The delivery is not failed (for example already retried), or the workflow now publishes to a different account than the failed delivery. |
| 409 | WORKFLOW_PREPARATION_CONFLICT WORKFLOW_CHANGED WORKFLOW_RECONCILIATION_REQUIRED WORKFLOW_LOOP | The 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. |
| 413 | ASSET_UPLOAD_TOO_LARGE | File larger than the upload limit. |
| 415 | — | Wrong content type (JSON expected, or multipart for uploads). |
| 422 | — | Content or consent not compatible with a destination. |
| 429 | RATE_LIMITED UPLOAD_BUSY UPLOAD_QUOTA_EXCEEDED | Rate limit, upload slot or daily direct-upload volume exhausted. Wait for Retry-After. |
| 503 | DIRECT_UPLOAD_UNAVAILABLE ACCOUNT_DISCONNECT_FAILED WORKFLOW_PREPARATION_DISABLED WORKFLOW_PREPARATION_UNAVAILABLE | Temporarily 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. |
| 508 | WORKFLOW_LOOP | The 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.
| Required | POST /posts, POST /workflows, POST /posts/late/resolve, POST /uploads |
|---|---|
| Optional | PUT, DELETE (including DELETE /uploads/{id} to cancel an upload), POST /uploads/{id}/complete, workflow pause, resume and retries. Honored when sent. |
| Not used | POST /assets. Uploading the same file again returns the same asset. |
| Kept for | 30 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
| Response | Do this |
|---|---|
Timeout, network error, 5xx | Retry 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. |
429 | Wait Retry-After seconds, then retry with the same key. |
409 REQUEST_UNCONFIRMED | Read the post, workflow or upload to see whether it was created. Don't switch to a new key. |
Other 4xx | Fix 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.
| Bucket | Starter | Pro | Expert |
|---|---|---|---|
All requests total | 120 | 300 | 600 |
Writes writes | 30 | 60 | 120 |
Uploads uploads | 6 | 12 | 20 |
Analytics analytics | 30 | 60 | 120 |
TikTok creator info creatorInfo | 6 | 6 | 6 |
- 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-RemainingandX-RateLimit-Reset(epoch seconds), plus headers for the bucket used. - A
429includesRetry-Afterin 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.
- 2026-11-01
MCP server. AI assistants such as Claude and ChatGPT can connect to
https://server.repostly.app/mcpand 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. - 2026-11-01
Workflow retries.
POST /workflows/{id}/preparations/{preparationId}/retryandPOST /workflows/{id}/posts/{postId}/retry.GET /workflows/{id}/activitynow returnsfailedPosts(withretryableandavailable), each processing item'sgenerationand afailedPostsCursor. New error codes:WORKFLOW_UNAVAILABLE,WORKFLOW_POST_NOT_RETRYABLE,WORKFLOW_POST_DESTINATION_CHANGED,WORKFLOW_ACCOUNT_UNAVAILABLEandWORKFLOW_PREPARATION_*. - 2026-11-01
Account disconnect.
DELETE /accounts/{id}with the newaccounts:writescope. 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 retryable503 ACCOUNT_DISCONNECT_FAILED. - 2026-11-01
Capability discovery and post filters.
GET /capabilitieslists supported content kinds, placements, defaults and workflow types.GET /postsacceptsstatus(all,current,failed,cancelled) anddestinationStatusfilters. - 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
| Name | In | Description |
|---|---|---|
platform stringOptional | query | - 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
| Name | In | Description |
|---|---|---|
platform stringOptional | query | Only accounts on this platform. - One of instagram facebook tiktok youtube threads |
limit integerOptional | query | Items per page (1–100, default 20). - Range 1–100 |
cursor stringOptional | query | Opaque 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
| Name | In | Description |
|---|---|---|
id stringRequired | path | 24-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
| Name | In | Description |
|---|---|---|
id stringRequired | path | 24-character hexadecimal ID. - Pattern ^[a-fA-F0-9]{24}$ |
Idempotency-Key stringOptional | header | Optional. 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
| Name | In | Description |
|---|---|---|
id stringRequired | path | 24-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
| Name | In | Description |
|---|---|---|
kind stringOptional | query | Only this kind. - One of video image |
limit integerOptional | query | Items per page (1–100, default 20). - Range 1–100 |
cursor stringOptional | query | Opaque 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
| Name | In | Description |
|---|---|---|
kind stringOptional | query | Override the inferred kind. - One of video image |
Request body multipart/form-data
| Name | Description |
|---|---|
file fileRequired | The 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
| Name | In | Description |
|---|---|---|
id stringRequired | path | 24-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
| Name | In | Description |
|---|---|---|
Idempotency-Key stringRequired | header | Unique 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
| Name | Description |
|---|---|
kind stringOptional | Optional; inferred from contentType and must match it. - One of video image |
contentType stringRequired | The file's MIME type. Signed into the upload URL. - One of video/mp4 video/quicktime image/jpeg image/png |
sizeBytes integerRequired | Exact file size in bytes (video ≤ 524288000 = 500 MiB, image ≤ 20971520 = 20 MiB). Signed into the upload URL. - Range ≥ 1 |
fileName stringOptional | Display 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
| Name | In | Description |
|---|---|---|
id stringRequired | path | 24-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
| Name | In | Description |
|---|---|---|
id stringRequired | path | 24-character hexadecimal ID. - Pattern ^[a-fA-F0-9]{24}$ |
Idempotency-Key stringOptional | header | Optional. 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
| Name | In | Description |
|---|---|---|
id stringRequired | path | 24-character hexadecimal ID. - Pattern ^[a-fA-F0-9]{24}$ |
Idempotency-Key stringOptional | header | Optional. 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
| Name | In | Description |
|---|---|---|
accountId stringOptional | query | Only posts with a destination on this account. - Pattern ^[a-fA-F0-9]{24}$ |
kind stringOptional | query | Only this content kind. - One of video image carousel text |
status stringOptional | query | Default 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 stringOptional | query | Only 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) | integerOptional | query | Only posts scheduled at or after this time. ISO 8601 date-time with offset or Unix milliseconds. |
to string (date-time) | integerOptional | query | Only posts scheduled before this time. ISO 8601 date-time with offset or Unix milliseconds. |
limit integerOptional | query | Items per page (1–100, default 20). - Range 1–100 |
cursor stringOptional | query | Opaque 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
| Name | In | Description |
|---|---|---|
Idempotency-Key stringRequired | header | Unique 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
| Name | Description |
|---|---|
caption stringOptional | Shared caption. Required for text posts. - Length ≤ 4000 chars |
scheduledAt string (date-time) | integerOptional | When 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 stringOptional | IANA time zone for display and email context (default UTC). It never reinterprets scheduledAt. - Length 1–64 chars |
videoAssetId stringOptional | Uploaded video asset (makes this a video post). - Pattern ^[a-fA-F0-9]{24}$ |
thumbnailAssetId stringOptional | Optional uploaded image asset used as the video thumbnail. - Pattern ^[a-fA-F0-9]{24}$ |
imageAssetIds string[]Optional | Uploaded image assets: one → image post, 2–20 → carousel. - Items ≤ 20 items - Unique items |
destinations object[]Required | - Items 1–50 items |
destinations[].accountId stringRequired | Connected account ID from GET /accounts. - Pattern ^[a-fA-F0-9]{24}$ |
destinations[].placement stringOptional | Where 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 stringOptional | Caption for this destination only (overrides the post caption). - Length ≤ 4000 chars |
destinations[].title stringOptional | YouTube: 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 stringOptional | YouTube and Facebook video description. - Length ≤ 5000 chars |
destinations[].visibility stringOptional | YouTube video visibility. Default public. - One of public unlisted private |
destinations[].tags string[]Optional | YouTube tags. - Items ≤ 100 items |
destinations[].categoryId stringOptional | YouTube category ID. - Length ≤ 3 chars |
destinations[].selfDeclaredMadeForKids booleanOptional | YouTube: made for kids. |
destinations[].containsSyntheticMedia booleanOptional | YouTube: altered or synthetic content disclosure. |
destinations[].notifySubscribers booleanOptional | YouTube: notify subscribers. |
destinations[].shareToFeed booleanOptional | Instagram Reels: also share to the feed. |
destinations[].thumbOffsetMs integerOptional | Instagram Reels: cover frame offset in milliseconds. - Range 0–86400000 |
destinations[].altText stringOptional | Image alt text (Instagram, Facebook, Threads). - Length ≤ 1000 chars |
destinations[].aiGenerated booleanOptional | Instagram / Facebook Reels: AI-generated label. |
destinations[].replyControl stringOptional | Threads reply control. - One of everyone accounts_you_follow mentioned_only parent_post_author_only followers_only |
destinations[].topicTag stringOptional | Threads topic tag. - Length ≤ 50 chars |
destinations[].tiktokPrivacyLevel stringOptional | TikTok 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 booleanOptional | TikTok: allow comments (explicit choice required). |
destinations[].allowDuet booleanOptional | TikTok video: allow duets (explicit choice required). |
destinations[].allowStitch booleanOptional | TikTok video: allow stitches (explicit choice required). |
destinations[].commercialContent booleanOptional | TikTok: commercial content disclosure; true exactly when brandedContent or promoteBrand is true. |
destinations[].brandedContent booleanOptional | TikTok: branded content (paid partnership). |
destinations[].promoteBrand booleanOptional | TikTok: promotes your own brand. |
destinations[].aiContent booleanOptional | TikTok: AI-generated content label. |
destinations[].tiktokPhotoTitle stringOptional | TikTok photo posts: title (required for photo posts). - Length ≤ 90 chars |
destinations[].tiktokAutoAddMusic booleanOptional | TikTok photo posts: let TikTok add music (required for photo posts). |
destinations[].tiktokConsent objectOptional | Explicit 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 booleanRequired | The creator confirmed TikTok's content sharing terms. |
destinations[].tiktokConsent.musicUsageConfirmed booleanRequired | The creator confirmed TikTok's music usage confirmation. |
destinations[].tiktokConsent.brandedContentPolicyConfirmed booleanOptional | Required 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
| Name | In | Description |
|---|---|---|
limit integerOptional | query | Items per page (1–100, default 20). - Range 1–100 |
cursor stringOptional | query | Opaque 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
| Name | In | Description |
|---|---|---|
Idempotency-Key stringRequired | header | Unique 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
| Name | Description |
|---|---|
action stringRequired | publish 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) | integerOptional | reschedule: the first new publishing time (must not be in the past). ISO 8601 date-time with offset or Unix milliseconds. |
spacingMinutes integerOptional | reschedule: 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
| Name | In | Description |
|---|---|---|
id stringRequired | path | Post 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
| Name | In | Description |
|---|---|---|
id stringRequired | path | 24-character hexadecimal ID. - Pattern ^[a-fA-F0-9]{24}$ |
Idempotency-Key stringOptional | header | Optional. 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
| Name | Description |
|---|---|
caption stringOptional | Shared caption. Required for text posts. - Length ≤ 4000 chars |
scheduledAt string (date-time) | integerOptional | When 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 stringOptional | IANA time zone for display and email context (default UTC). It never reinterprets scheduledAt. - Length 1–64 chars |
videoAssetId stringOptional | Uploaded video asset (makes this a video post). - Pattern ^[a-fA-F0-9]{24}$ |
thumbnailAssetId stringOptional | Optional uploaded image asset used as the video thumbnail. - Pattern ^[a-fA-F0-9]{24}$ |
imageAssetIds string[]Optional | Uploaded image assets: one → image post, 2–20 → carousel. - Items ≤ 20 items - Unique items |
destinations object[]Required | - Items 1–50 items |
destinations[].accountId stringRequired | Connected account ID from GET /accounts. - Pattern ^[a-fA-F0-9]{24}$ |
destinations[].placement stringOptional | Where 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 stringOptional | Caption for this destination only (overrides the post caption). - Length ≤ 4000 chars |
destinations[].title stringOptional | YouTube: 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 stringOptional | YouTube and Facebook video description. - Length ≤ 5000 chars |
destinations[].visibility stringOptional | YouTube video visibility. Default public. - One of public unlisted private |
destinations[].tags string[]Optional | YouTube tags. - Items ≤ 100 items |
destinations[].categoryId stringOptional | YouTube category ID. - Length ≤ 3 chars |
destinations[].selfDeclaredMadeForKids booleanOptional | YouTube: made for kids. |
destinations[].containsSyntheticMedia booleanOptional | YouTube: altered or synthetic content disclosure. |
destinations[].notifySubscribers booleanOptional | YouTube: notify subscribers. |
destinations[].shareToFeed booleanOptional | Instagram Reels: also share to the feed. |
destinations[].thumbOffsetMs integerOptional | Instagram Reels: cover frame offset in milliseconds. - Range 0–86400000 |
destinations[].altText stringOptional | Image alt text (Instagram, Facebook, Threads). - Length ≤ 1000 chars |
destinations[].aiGenerated booleanOptional | Instagram / Facebook Reels: AI-generated label. |
destinations[].replyControl stringOptional | Threads reply control. - One of everyone accounts_you_follow mentioned_only parent_post_author_only followers_only |
destinations[].topicTag stringOptional | Threads topic tag. - Length ≤ 50 chars |
destinations[].tiktokPrivacyLevel stringOptional | TikTok 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 booleanOptional | TikTok: allow comments (explicit choice required). |
destinations[].allowDuet booleanOptional | TikTok video: allow duets (explicit choice required). |
destinations[].allowStitch booleanOptional | TikTok video: allow stitches (explicit choice required). |
destinations[].commercialContent booleanOptional | TikTok: commercial content disclosure; true exactly when brandedContent or promoteBrand is true. |
destinations[].brandedContent booleanOptional | TikTok: branded content (paid partnership). |
destinations[].promoteBrand booleanOptional | TikTok: promotes your own brand. |
destinations[].aiContent booleanOptional | TikTok: AI-generated content label. |
destinations[].tiktokPhotoTitle stringOptional | TikTok photo posts: title (required for photo posts). - Length ≤ 90 chars |
destinations[].tiktokAutoAddMusic booleanOptional | TikTok photo posts: let TikTok add music (required for photo posts). |
destinations[].tiktokConsent objectOptional | Explicit 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 booleanRequired | The creator confirmed TikTok's content sharing terms. |
destinations[].tiktokConsent.musicUsageConfirmed booleanRequired | The creator confirmed TikTok's music usage confirmation. |
destinations[].tiktokConsent.brandedContentPolicyConfirmed booleanOptional | Required 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
| Name | In | Description |
|---|---|---|
id stringRequired | path | 24-character hexadecimal ID. - Pattern ^[a-fA-F0-9]{24}$ |
Idempotency-Key stringOptional | header | Optional. 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
| Name | In | Description |
|---|---|---|
id stringRequired | path | Post ID. Posts imported from a connected account use the form imported:<id>. - Pattern ^(imported:)?[a-fA-F0-9]{24}$ |
range stringOptional | query | - One of 24h 7d 30d - Default 7d |
timezone stringOptional | query | Time 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
| Name | In | Description |
|---|---|---|
limit integerOptional | query | Items per page (1–100, default 20). - Range 1–100 |
cursor stringOptional | query | Opaque 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
| Name | In | Description |
|---|---|---|
Idempotency-Key stringRequired | header | Unique 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
| Name | Description |
|---|---|
sourceAccountId stringRequired | Account to repost from. - Pattern ^[a-fA-F0-9]{24}$ |
destinationAccountId stringRequired | Account to publish to. - Pattern ^[a-fA-F0-9]{24}$ |
sourceContent stringRequired | Source content type to repost. - One of reels video videos shorts text image carousel |
destinationContent stringRequired | Destination content type. - One of reels video videos shorts text image carousel |
mode stringRequired | new_posts: repost new content as it appears. backlog: work through existing content on a schedule. - One of new_posts backlog |
backlog objectOptional | Required when mode is backlog. |
backlog.startAt string (date-time) | integerOptional | from_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 stringOptional | Time zone of postTimes (default UTC). - Length 1–64 chars |
backlog.order stringOptional | Default oldest_first. - One of oldest_first from_date |
backlog.postTimes string[]Required | Daily publishing times, 24-hour HH:mm. - Items 1–24 items - Unique items |
tiktokDeclaration booleanOptional | Required 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
| Name | In | Description |
|---|---|---|
id stringRequired | path | 24-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
| Name | In | Description |
|---|---|---|
id stringRequired | path | 24-character hexadecimal ID. - Pattern ^[a-fA-F0-9]{24}$ |
Idempotency-Key stringOptional | header | Optional. 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
| Name | Description |
|---|---|
sourceAccountId stringRequired | Account to repost from. - Pattern ^[a-fA-F0-9]{24}$ |
destinationAccountId stringRequired | Account to publish to. - Pattern ^[a-fA-F0-9]{24}$ |
sourceContent stringRequired | Source content type to repost. - One of reels video videos shorts text image carousel |
destinationContent stringRequired | Destination content type. - One of reels video videos shorts text image carousel |
mode stringRequired | new_posts: repost new content as it appears. backlog: work through existing content on a schedule. - One of new_posts backlog |
backlog objectOptional | Required when mode is backlog. |
backlog.startAt string (date-time) | integerOptional | from_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 stringOptional | Time zone of postTimes (default UTC). - Length 1–64 chars |
backlog.order stringOptional | Default oldest_first. - One of oldest_first from_date |
backlog.postTimes string[]Required | Daily publishing times, 24-hour HH:mm. - Items 1–24 items - Unique items |
tiktokDeclaration booleanOptional | Required 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
| Name | In | Description |
|---|---|---|
id stringRequired | path | 24-character hexadecimal ID. - Pattern ^[a-fA-F0-9]{24}$ |
Idempotency-Key stringOptional | header | Optional. 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
| Name | In | Description |
|---|---|---|
id stringRequired | path | 24-character hexadecimal ID. - Pattern ^[a-fA-F0-9]{24}$ |
Idempotency-Key stringOptional | header | Optional. 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
| Name | In | Description |
|---|---|---|
id stringRequired | path | 24-character hexadecimal ID. - Pattern ^[a-fA-F0-9]{24}$ |
Idempotency-Key stringOptional | header | Optional. 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
| Name | In | Description |
|---|---|---|
id stringRequired | path | 24-character hexadecimal ID. - Pattern ^[a-fA-F0-9]{24}$ |
limit integerOptional | query | Items per page (1–100, default 20). - Range 1–100 |
processingCursor stringOptional | query | Opaque nextCursor from the previous page. - Length 1–512 chars |
postsCursor stringOptional | query | Opaque nextCursor from the previous page. - Length 1–512 chars |
failedPostsCursor stringOptional | query | Opaque 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
| Name | In | Description |
|---|---|---|
id stringRequired | path | 24-character hexadecimal ID. - Pattern ^[a-fA-F0-9]{24}$ |
preparationId stringRequired | path | processing.data[].id from GET /workflows/{id}/activity. - Pattern ^[a-fA-F0-9]{24}$ |
Idempotency-Key stringOptional | header | Optional. 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
| Name | Description |
|---|---|
generation integerRequired | The 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
| Name | In | Description |
|---|---|---|
id stringRequired | path | 24-character hexadecimal ID. - Pattern ^[a-fA-F0-9]{24}$ |
postId stringRequired | path | failedPosts.data[].id from GET /workflows/{id}/activity. - Pattern ^[a-fA-F0-9]{24}$ |
Idempotency-Key stringOptional | header | Optional. 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
| Name | In | Description |
|---|---|---|
range stringOptional | query | Time window ending now. - One of 24h 7d 30d 365d all - Default 30d |
accountId stringOptional | query | Only this connected account. - Pattern ^[a-fA-F0-9]{24}$ |
platform stringOptional | query | Only this platform. - One of instagram facebook tiktok youtube threads |
timezone stringOptional | query | Time 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
| Name | In | Description |
|---|---|---|
metric stringRequired | query | - One of views likes comments followers |
range stringOptional | query | Time window ending now. - One of 24h 7d 30d 365d all - Default 30d |
accountId stringOptional | query | Only this connected account. - Pattern ^[a-fA-F0-9]{24}$ |
platform stringOptional | query | Only this platform. - One of instagram facebook tiktok youtube threads |
timezone stringOptional | query | Bucket boundaries' time zone (default UTC). - Length 1–64 chars |
endAt string (date-time) | integerOptional | query | Any 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
| Name | In | Description |
|---|---|---|
range stringOptional | query | - One of 24h 7d 30d - Default 7d |
accountId stringOptional | query | Only this connected account. - Pattern ^[a-fA-F0-9]{24}$ |
platform stringOptional | query | Only this platform. - One of instagram facebook tiktok youtube threads |
timezone stringOptional | query | Time 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
| Name | In | Description |
|---|---|---|
range stringOptional | query | Time window ending now. - One of 24h 7d 30d 365d all - Default 30d |
accountId stringOptional | query | Only this connected account. - Pattern ^[a-fA-F0-9]{24}$ |
platform stringOptional | query | Only this platform. - One of instagram facebook tiktok youtube threads |
timezone stringOptional | query | Time 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
}
]
}