wyro

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 " header. No key yet? Create a test key with POST /v1/sandbox (no sign-up).

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 . It is not a workspace key.

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.