Publish Threads image
threads_publish_imagePublishes one approved image post (text plus public HTTPS image_url, optional topic_tag) to Threads; uses a stable idempotency_key and waits for media FINISHED to prevent duplicate retries.
Instructions
Publish one approved image post (text + public HTTPS image_url, optional topic_tag of 1-50 characters without '.' or '&') to Threads. idempotency_key must remain stable for retries of the same logical publication. The media container is published only after Threads reports it FINISHED. The tool prevents blind retries when provider outcome is unknown.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"text": "<text>",
"image_url": "<image_url>",
"idempotency_key": "<idempotency_key>"
},
"name": "threads_publish_image"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| text | Yes | ||
| image_url | Yes | ||
| topic_tag | No | ||
| idempotency_key | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| status | Yes | ||
| message | No | ||
| post_id | No | ||
| permalink | No | ||
| recovered | No | ||
| idempotency_key | Yes |