Errors
Every error has the same format:
{
"error": {
"code": "media_required",
"lang": "en",
"message": { "en": "…", "es": "…", "pt": "…" },
"fix": { "en": "…", "es": "…", "pt": "…" },
"docs_url": "https://wyroapi.com/docs/errores#media_required",
"details": { "platform": "instagram" }
}
}
message and fix always include every language; lang says which one fits you.
missing_api_key (HTTP 401)
The API key is missing.
How to fix it: Send the "Authorization: Bearer
invalid_api_key (HTTP 401)
The API key is invalid or was revoked.
How to fix it: Check that the key starts with "wyro_sk_" and is complete. You can create a new one with POST /v1/sandbox.
sandbox_expired (HTTP 401)
The test key expired (it lasts 72 hours).
How to fix it: Create a new test key with POST /v1/sandbox, or connect a real account to keep using the same key.
key_expired (HTTP 402)
The trial period has ended.
How to fix it: Show the user the link in details.payment_url to activate a plan. The same key publishes again, no reconfiguration needed.
workspace_suspended (HTTP 403)
This workspace is suspended.
How to fix it: Contact us at https://github.com/wyroapi/wyro/issues.
rate_limited (HTTP 429)
Too many requests.
How to fix it: Wait the number of seconds in the Retry-After header and try again.
sandbox_limit (HTTP 429)
Too many test keys were created from this IP.
How to fix it: Reuse the key you already have (it lasts 72 hours) or wait an hour.
validation_error (HTTP 400)
The request has invalid data.
How to fix it: Check the field listed in details against /openapi.json.
platform_not_supported (HTTP 400)
That social network is not supported.
How to fix it: Use one of: instagram, facebook, tiktok, linkedin, twitter, threads, youtube, pinterest.
no_account_for_platform (HTTP 400)
There is no connected account for that network.
How to fix it: List accounts with GET /v1/accounts. To connect a real account use POST /v1/connect.
media_required (HTTP 400)
That network needs an image or a video.
How to fix it: Add "media": [{"url": "https://..."}] with a public URL. TikTok and YouTube need a video.
text_too_long (HTTP 400)
The text exceeds the network's limit.
How to fix it: Shorten the text or post to that network separately. Limits are in details.
admin_only (HTTP 403)
This route is for the platform administrator only.
How to fix it: Use the analytics token (ANALYTICS_TOKEN) or the admin token, not a workspace key. Your workspace metrics are at GET /v1/analytics/overview.
invalid_partner_token (HTTP 401)
The partner token is invalid.
How to fix it: Use the partner token we gave you, as Authorization: Bearer
workspace_not_found (HTTP 404)
The workspace does not exist or does not belong to this partner.
How to fix it: List your workspaces with GET /v1/partner/workspaces.
post_not_cancellable (HTTP 409)
That post can no longer be cancelled.
How to fix it: Only scheduled posts that have not gone out can be cancelled. To delete a published post, do it on the network.
account_not_disconnectable (HTTP 409)
That account cannot be disconnected.
How to fix it: Only active real accounts can be disconnected. The simulated test accounts cannot.
account_not_found (HTTP 404)
The account does not exist in this workspace.
How to fix it: List accounts with GET /v1/accounts.
post_not_found (HTTP 404)
The post does not exist.
How to fix it: Check the id (it starts with post_). List posts with GET /v1/posts.
account_disconnected (HTTP 409)
That account is disconnected.
How to fix it: Ask the user to reconnect it with the link in details.connect_url (or POST /v1/connect).
provider_error (HTTP 502)
The social network did not accept the post right now.
How to fix it: If details.retryable is true, retry in a minute. Otherwise check the content (format, length, size) and the connected account.
post_not_reschedulable (HTTP 409)
That post is no longer scheduled: only a post that has not gone out can be rescheduled.
How to fix it: Check its status with GET /v1/posts/{id}. If it was already published, create a new post with POST /v1/posts.
not_found (HTTP 404)
The route does not exist.
How to fix it: See /openapi.json for the available routes.
internal_error (HTTP 500)
Something failed on our side.
How to fix it: Try again in a few seconds. If it keeps happening, open an issue at https://github.com/wyroapi/wyro/issues with the request_id.