Skip to main content
GET
Get a Tweet Draft by ID with the Xquik API

Retrieve One Tweet Draft by ID

Retrieve one saved tweet draft from your Xquik account. The response contains its ID, text, optional topic, optional goal, and timestamps. It does not return thread order, media attachments, reply targets, or publishing results. Use the ID returned by Create Draft or List Drafts. This route reads that record without creating, changing, publishing, or deleting it. Xquik drafts are separate from X’s native Unsent posts. This endpoint cannot retrieve drafts stored inside the X compose interface.
Free - does not consume credits

Read the Tweet Draft Fields

The API returns one compact draft object. Optional fields are omitted when they were not supplied during creation. The text field contains one saved string. It can contain up to 25,000 characters. The topic field can contain up to 500 characters. The goal value can be engagement, followers, authority, or conversation. This response contains no public tweet ID. A draft remains private until a separate X write request publishes approved text.

Keep Xquik and Native X Drafts Separate

Native X drafts appear inside the X compose interface. Native thread drafts can contain several connected posts. Native posts can also include photos, GIFs, or video. An Xquik draft stores one text value plus optional composition context. It has no thread sequence, media collection, reply target, or native X draft ID. Do not send a public tweet ID to this route. Tweet IDs and Xquik draft IDs identify different resources.

Build a Tweet Draft Review Workflow

  1. Save tweet text through POST /drafts.
  2. Store the returned Xquik draft ID.
  3. Retrieve the draft before human or agent review.
  4. Compare its text, topic, goal, and timestamps.
  5. Approve or reject the exact returned text.
  6. Publish approved text through a separate X write route.
  7. Delete the saved draft when retention rules allow it.
This route provides no edit operation. Create a new draft when approved text must change. Keep the old ID until reviewers accept the replacement. Use Create Tweet only after approval. Reading a draft never sends text to followers or creates likes and replies.

Recover From Tweet Draft Lookup Errors

The route returns the same 404 for missing drafts and other-account IDs. This boundary prevents clients from discovering another account’s draft IDs. Never retry 400, 401, or 404 without changing the request. Retry 429 only after the server’s delay.

Answer Tweet Draft Retrieval Questions

Where Can I Find an Xquik Tweet Draft?

Call List Drafts first. Copy the returned id, then request this endpoint.

Can This API Retrieve My Native X Drafts?

No. Native X drafts remain under Unsent posts. This route reads Xquik records created through the draft API.

Does One Draft Include a Twitter Thread?

No. The response contains one text string. It includes no thread order or connected-post collection.

Does the Response Include Media or Reply Targets?

No. The canonical draft object contains no media, reply target, or tweet ID.

Can This Route Publish or Update the Draft?

No. This route only reads the saved record. Create replacement text or publish through separate endpoints.

Can I Retrieve a Deleted Draft?

No. A deleted draft returns 404. Xquik provides no restore endpoint.

Does Retrieving a Draft Consume Credits?

No. This authenticated lookup is free and consumes no Xquik credits.

Path Parameters

string
required
The unique Xquik draft ID. Copy it from Create Draft or List Drafts.

Headers

string
Your Xquik API key. Generate one from the dashboard.
string
An OAuth bearer token formatted as Bearer YOUR_TOKEN. Send this header or x-api-key, not both.

Response

200 OK

string
Unique draft ID.
string
The draft tweet text.
string
Topic the tweet is about. Omitted if not set.
string
Optimization goal. Omitted if not set.
string
ISO 8601 creation timestamp.
string
ISO 8601 last update timestamp.

400 Invalid ID

The provided draft ID is not a valid format.

401 Unauthenticated

Missing or invalid API key.

404 Not Found

No draft exists with this ID, or it belongs to a different account.

429 Rate Limited

Too many requests. Wait for the Retry-After header before retrying.
Related: List Drafts to see all your drafts, Create Draft to save a new one, or Delete Draft to remove this draft.