What your agent can do

Account status account_status

Where the account stands: handle (the X account this key acts for), key_name (this key's name), plan, the tweet length limit, what is left of this period's tweets and link posts, storage (bytes stored, the cap, and when the next posted file frees space), drafts waiting for the owner's approval (pending_approvals), drafts that failed (failed: X said no, or nothing was sent) and video_enabled (whether add_video works for this account; the owner turns it on), and drafts that need a check on X (needs_check, with check_reason: part of the thread may be live, so only the owner can settle it). Each list is its first 50: `more` says which have another page, and list_drafts pages through them. Read-only.

No arguments.

No refusal of its own.

Whoami whoami

Who this key acts for: handle (the X account), key_name (this key's name) and account_id. Read-only. It does not post.

No arguments.

No refusal of its own.

Quote post quote_post

Length-check a thread before drafting it. Counts X's weighted length (a link counts 23, an emoji 2), flags empty tweets and more than one cashtag, and says which tweets carry a link (and so use a link post). Runs locally; the limit follows the account when an API key is set. The result includes warnings for hidden characters, a tweet that is too long, a link to a post on X, an empty tweet, and more than one cashtag. Read-only.

No refusal of its own.

Create draft create_draft

Save a new draft thread for the owner to review. It is not posted and not queued: the owner approves it in the Evenpost app. Returns draft_id, version_id and warnings (hidden characters removed, too long, a link to a post on X, an empty tweet, or more than one cashtag). Each tweet is a string or {text, photos?}, where photos are ids from add_photo; a new draft has none yet, so attach photos with add_photo.

No refusal of its own.

Update draft update_draft

Replace the tweets of an existing draft (send all of them) and return warnings for hidden characters, length, a link to a post on X, an empty tweet, or cashtags. Each tweet is a string or {text, photos?}. Photos you leave out stay with the tweet at the same position. If the draft has photos and you change the tweet count or the order of the tweets, every tweet must carry `photos` (a list of photo ids from get_post, or [] for none), or the call is refused with 422 photos_required and nothing is saved; photos you leave out of a restructure are only detached from this draft. Rewording a tweet in place is fine without photos. A tweet the owner has edited is protected: if the draft changed since you read it the call is refused until you re-read it with get_post and send its version_id. Cannot touch a draft that is posting or posted.

It can refuse with:

• If the draft has photos and you change the tweet count or the order of the tweets, every tweet must carry `photos` (a list of photo ids from get_post, or [] for none), or the call is refused with 422 photos_required and nothing is saved; photos you leave out of a restructure are only detached from this draft.
• A tweet the owner has edited is protected: if the draft changed since you read it the call is refused until you re-read it with get_post and send its version_id.
• Cannot touch a draft that is posting or posted.

Add photo add_photo

Attach one local image file (PNG, JPEG or WEBP, up to 5 MB) to one tweet of a draft; call it once per photo. The server checks the file's bytes, not its name. Refused: animated images, transparent or lossless WEBP, JPEGs over 12,000 px a side or 100 megapixels, PNGs over 8192 px a side, and interlaced or low-bit-grey PNGs with transparency. A JPEG up to 4096 px keeps its pixels; a larger one is resized. Location and camera data are removed (the rotation stays), and other PNG transparency is flattened onto white. A tweet carries up to 4 photos, and an account can upload 50 photos or 100 MB a day.

It can refuse with:

• Refused: animated images, transparent or lossless WEBP, JPEGs over 12,000 px a side or 100 megapixels, PNGs over 8192 px a side, and interlaced or low-bit-grey PNGs with transparency.
• Paths must be under the current directory or your home folder.
• add_photo takes images up to 5 MB.

Add video add_video

Attach one local video to one tweet of a draft. MP4 or MOV. H.264 and AAC-LC. Up to 512 MB and 10 minutes. One video per tweet. No photos on that tweet. 10 videos or 1 GB a day. The owner approves it in the app. A file that already fits is uploaded unchanged; anything else is converted on this Mac with ffmpeg at high quality when ffmpeg is installed. A conversion can take minutes.

It can refuse with:

• Video is not turned on for this account yet.
• add_video takes videos up to 512 MB.
• Use another tweet, or remove the photos on this one.
• Paths must be under the current directory or your home folder.

Remove photo remove_photo

Remove one photo or video from a tweet of a draft.

No refusal of its own.

Reorder photos reorder_photos

Set the order of a tweet's photos. List every photo id the tweet has, in the order you want; the first is the lead image.

No refusal of its own.

Request approval request_approval

Nudge the owner: sends a "needs approval" notification for this draft. It only asks. It does not approve, queue or post anything; the owner decides in the Evenpost app.

No refusal of its own.

Archive draft archive_draft

Archive a pending draft that this key created and that was never queued or posted. It cannot archive another key's draft, or one that was queued or posted: the owner does that in the app. It does not post or delete.

It can refuse with:

• It cannot archive another key's draft, or one that was queued or posted: the owner does that in the app.

List queue list_queue

The owner's posting queue, soonest first, 50 at a time: what is scheduled, and what needs attention. Returns { items, next_cursor }; send next_cursor back as `cursor` for the next page (null means that was the last). A page can hold fewer than 50 when the drafts are long. Walking pages is not a snapshot: for failed or needs_check drafts use list_drafts with that status. Read-only.

No refusal of its own.

List drafts list_drafts

Drafts in one status, newest first, 50 at a time. Returns { items, next_cursor }; send next_cursor back as `cursor` for the next page (null means that was the last). Read-only.

No refusal of its own.

Get post get_post

One draft in full: its tweets (each with text, the ids of its photos, media_kinds, receipts, and owner_edited_at), status, version_id, warnings, and whether the owner has edited it. Echo a tweet's photos back to update_draft to keep them. receipts is read-only. Read-only.

No refusal of its own.

List spend list_spend

The plan, tweets and link posts used and left this period, and the account's tweet length limit. Read-only.

No arguments.

No refusal of its own.