Sign in
latestOpenAPI 3.0.02026-08-1610635191.3 KB

355890b6b4cc

X

Refine an existing X (Twitter) post

Refines an existing tweet based on user instructions while maintaining context. Costs 1 credit. Can update the tweet text and any associated data tables or charts.

post/x/refine

Request body

tweetIdstring required

The unique ID of the tweet to refine

promptstring

Instructions for how to refine the tweet

promptAudioUrlstring

URL to an audio file to transcribe and use as refinement instructions. Required if prompt is not provided.

Example request

{
  "tweetId": "550e8400-e29b-41d4-a716-446655440000",
  "prompt": "Make it more engaging and add relevant emojis",
  "promptAudioUrl": "https://example.com/refinement-audio.mp3"
}

Response

Tweet refined successfully

successboolean

Example response

{
  "success": true,
  "post": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "requestId": "660e8400-e29b-41d4-a716-446655440000",
    "result": "🚀 Just launched our new AI feature! It's revolutionizing how teams collaborate. Check it out! 💡",
    "type": "tweet",
    "order": 1,
    "createdOn": "2024-01-15T10:35:00Z",
    "tweetImageUrl": "https://cdn.example.com/user-image.jpg",
    "dataTableImageUrl": "https://cdn.example.com/table-updated.png",
    "barChartImageUrl": "https://cdn.example.com/chart-updated.png"
  }
}