Threads API Troubleshooting

Updated: Jul 14, 2025

Publishing Does Not Return a Media ID

If you are able to create a container for a video but the POST /{threads-user-id}/threads_publish endpoint does not return the published media ID, then you can get the container’s publishing status by querying the GET /{threads-container-id} endpoint. This endpoint will return one of the following:

EXPIRED — The container was not published within 24 hours and has expired.

ERROR — The container failed to complete the publishing process.

FINISHED — The container and its media object are ready to be published.

IN_PROGRESS — The container is still in the publishing process.

PUBLISHED — The container’s media object has been published.

In case of error the endpoint will return one of the following error messages:

FAILED_DOWNLOADING_VIDEO

FAILED_PROCESSING_AUDIO

FAILED_PROCESSING_VIDEO

INVALID_ASPEC_RATIO

INVALID_BIT_RATE

INVALID_DURATION

INVALID_FRAME_RATE

INVALID_AUDIO_CHANNELS

INVALID_AUDIO_CHANNEL_LAYOUT

UNKNOWN

We recommend querying a container’s status once per minute, for no more than 5 minutes.

Example Request

curl -s -X GET \
"https://graph.threads.net/v1.0/<MEDIA_CONTAINER_ID>?fields=status,error_message&access_token=<THREADS_ACCESS_TOKEN>"

Example Response

{
  "status": "FINISHED",
  "id": "17889615691921648"
}

Example Response (in case of error)

{
  "status": "ERROR",
  "id": "17889615691921648",
  "error_message": "FAILED_DOWNLOADING_VIDEO"
}

Retrieve Quota Limits

To validate that a user has not exhausted their API quota limits for publishing, reply publishing, deleting, and location search, they can make a call to the GET {threads-user-id}/threads_publishing_limit endpoint. This will return a user’s current Threads API usage total.

Example Request

curl -s -X GET
"https://graph.threads.net/v1.0/<THREADS_USER_ID>/threads_publishing_limit?fields=quota_usage,config,reply_quota_usage,reply_config,delete_quota_usage,delete_config,location_search_quota_usage,location_search_config&access_token=<THREADS_ACCESS_TOKEN>"

Example Response

{
  "data": [
    {
      "quota_usage": 0,
      "config": {
        "quota_total": 250,
        "quota_duration": 86400
      },
      "reply_quota_usage": 0,
      "reply_config": {
        "quota_total": 1000,
        "quota_duration": 86400
      },
      "delete_quota_usage": 0,
      "delete_config": {
        "quota_total": 100,
        "quota_duration": 86400
      },
      "location_search_quota_usage": 0,
      "location_search_config": {
        "quota_total": 500,
        "quota_duration": 86400
      }
    }
  ]
}