Drafts

Create, list, edit, and delete draft tweets. Drafts are private to your account.

drafts.list(opts?)

List your draft tweets. Uses the GraphQL FetchDraftTweets query.

Option	Type	Description
opts.ascending	boolean	Sort order (default false, newest first)

const drafts = await client.drafts.list();
// [{ rest_id, tweet_create_request: { status, ... } }, ...]

drafts.create(text, opts?)

Save a new draft. Uses the GraphQL CreateDraftTweet mutation.

Option	Type	Description
text	string	The draft body
opts.mediaIds	string[]	Attached media ids (from the media upload flow)
opts.replyTo	string	Tweet id this draft replies to

const res = await client.drafts.create("a thought for later");
const draftId = res.data.tweet.rest_id;

drafts.edit(draftId, text, opts?)

Replace a draft's content. Same opts as create. Uses the GraphQL EditDraftTweet mutation.

await client.drafts.edit(draftId, "a revised thought");

drafts.remove(draftId)

Delete a draft. Uses the GraphQL DeleteDraftTweet mutation.

await client.drafts.remove(draftId);