Developer documentation
Error codes
Causes and next steps
REST errors have a stable English code and currently a Korean message. This table explains the same codes in English. Limit violations include limit and actual; per-platform violations include platform.
| Code | HTTP | Cause and next step |
|---|---|---|
| unauthenticated | 401 | You are not signed in or authentication is missing. Sign in or provide a valid key. |
| invalid_api_key | 401 | The API key is invalid. Check the key and try again. |
| api_key_revoked | 401 | This API key was revoked. Create a new key. |
| api_key_expired | 401 | This API key expired. Create a new key. |
| verification_required | 403 | Verification is incomplete. Verify your email and phone number. |
| forbidden_scope | 403 | This key cannot perform the action. Grant the required scope. |
| invalid_params | 400 | A required value is missing or malformed. Check the request fields. |
| workspace_required | 400 | No workspace was selected. Choose a workspace for this request. |
| validation_failed | 422 | The post violates platform rules. Fix the reported issues and validate again. |
| content_too_long | 422 | The text exceeds the character limit. Shorten it. |
| content_too_large | 422 | The text exceeds the byte limit. Shorten it. |
| media_required | 422 | This platform requires media. Add an image or video. |
| media_too_many | 422 | Too many media files were selected. Remove some files. |
| media_mixed | 422 | Images and videos cannot be mixed. Select one media type. |
| media_type_not_supported | 422 | This file type is unsupported. Use a supported format. |
| media_too_large | 422 | The file exceeds the size limit. Upload a smaller file. |
| media_aspect_ratio | 422 | The image or video aspect ratio is invalid. Use a file that fits the platform rules. |
| media_width_out_of_range | 422 | The image width is outside the platform range. Resize it and upload again. |
| media_too_short | 422 | The video is too short. Meet the platform's minimum duration. |
| media_too_long | 422 | The video is too long. Upload a shorter video. |
| media_not_found | 404 | The media was not found. Check its ID and workspace. |
| media_not_ready | 422 | The media upload is not verified yet. Wait for completion and try again. |
| media_expired | 404 | The media retention period ended. Upload a new file and publish a new post. |
| media_file_invalid | 422 | The uploaded file is damaged or differs from the requested format or size. Check the file. |
| media_in_use | 409 | This file is in use by a post or upload link. Detach it or remove the post first. |
| upload_link_invalid | 404 | The upload link was not found. Ask the agent for a new link. |
| upload_link_expired | 410 | The 30-minute upload link expired. Ask the agent for a new link. |
| upload_link_full | 409 | This link has reached its file limit. Ask the agent for a new link. |
| media_url_invalid | 422 | The media URL is not a valid HTTPS URL. Check the address. |
| media_url_blocked | 422 | The media URL is unsafe. Use a public HTTPS address. |
| media_url_unreachable | 422 | The media URL could not be reached. Check the address and access settings. |
| scheduled_at_invalid | 422 | The scheduled time has no timezone. Include a timezone offset. |
| scheduled_at_range | 422 | The scheduled time is outside the allowed range. Choose another time. |
| queue_slot_taken | 409 | This queue minute already contains a post. Choose another time. |
| queue_slot_rule_not_found | 404 | The queue slot rule was not found. Refresh the list. |
| queue_slot_rule_revoked | 409 | A revoked queue slot rule cannot be edited. Create a new rule. |
| queue_slot_unavailable | 409 | No queue slot is available. Check the rules and date range. |
| account_not_connected | 404 | The connected account was not found. Connect a platform account. |
| account_has_active_work | 409 | This account has pending schedule, publish, or deletion work. Finish it or edit or delete scheduled posts first. |
| account_expired | 422 | The platform connection expired. Reconnect the account. |
| account_restricted | 422 | The platform account is restricted. Check the reason on the platform. |
| platform_not_ready | 422 | This platform cannot publish yet. Select a live platform. |
| duplicate_post | 409 | The same post was requested recently. Check the existing post. |
| idempotency_key_reused | 422 | This request key was reused with different content. Use a new key. |
| post_not_editable | 409 | This post cannot be edited in its current state. Select a draft or scheduled post. |
| post_changed | 409 | The post changed during validation. Refresh it and try again. |
| post_not_found | 404 | The post was not found. Check its ID and workspace. |
| webhook_not_found | 404 | The webhook subscription was not found. Check its ID and workspace. |
| webhook_revoked | 409 | A revoked webhook cannot be edited. Create a new subscription. |
| webhook_delivery_not_found | 404 | The webhook delivery was not found. Check its ID and workspace. |
| webhook_subscription_inactive | 409 | The webhook is paused or revoked. Retry from an active subscription. |
| webhook_delivery_not_retryable | 409 | Only confirmed failed deliveries can be retried. Check the delivery status. |
| instagram_dm_backfill_not_found | 404 | The past-comment preparation job was not found. Check the workspace and job list. |
| instagram_dm_backfill_conflict | 409 | The preparation state or request changed. Refresh the results and check the original request. |
| instagram_dm_rule_not_found | 404 | The Instagram comment automation rule was not found. Refresh the list. |
| instagram_dm_rule_not_editable | 409 | This rule cannot be edited now. Pause an active rule first, or create a new one if it was revoked. |
| instagram_dm_not_approved | 409 | Instagram comment automation is not approved yet. Complete Meta app review and testing first. |
| instagram_dm_permission_missing | 409 | The connected Instagram account lacks comment automation permission. Reconnect it and grant the permission. |
| instagram_comments_not_approved | 409 | Manual Instagram comment management is not approved yet. Complete Meta app review and testing first. |
| instagram_comments_permission_missing | 409 | The connected Instagram account lacks comment management permission. Reconnect it and grant the permission. |
| instagram_comment_not_found | 404 | The comment was not found on this media. Check the media and comment IDs. |
| instagram_comment_not_replyable | 422 | This comment cannot receive a reply. Select a visible top-level comment. |
| instagram_comment_provider_unavailable | 503 | Instagram comments could not be checked. Try again later. |
| instagram_comment_action_not_found | 404 | The comment action was not found. Check its ID and workspace. |
| publish_in_flight | 409 | The post is being published. Wait for completion and check the result. |
| nothing_to_retry | 422 | No target can be retried. Check each target's status. |
| quota_exceeded | 402 | The monthly publishing quota was reached. Check its reset date or change the plan. |
| rate_limited | 429 | Too many requests were sent. Wait briefly and try again. |
| internal_error | 500 | The server encountered an error. Contact support with the request ID. |