Articles

Create an X Article

Creates a draft article. Upload images to the Media Room first, then set coverMediaId and reference inline images with <img data-media-id="...">. Nothing is sent to X.

post/v1/workspaces/{workspaceId}/articles

Request

  • Base URL: https://api.maevesocial.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.maevesocial.com/v1/workspaces/{workspaceId}/articles
  • Auth: HTTP bearer

Path parameters

workspaceIdstring uuid required

Workspace UUID.

Headers

idempotency-keystring required
Idempotency-Keystring

Retry with the same key and body to get the recorded result instead of a second article.

Request body

integrationIdstring uuid required

X integration from integrations.list whose content.canPublishArticles is true (X Premium).

titlestring required

Article title shown on X, up to 200 characters.

bodyHtmlstring

Article body as HTML: p, h1 to h3, strong, em, s, a href, blockquote, ul, ol, li, hr, br and img. Each img needs data-media-id set to a still image of 5 MB or less from the Media Room, and Maeve fills in its src. Up to 100,000 characters of text and 20 images.

coverMediaIdstring uuid

Media Room ID of a still image of 5 MB or less (not a GIF) to use as the cover.

Response

Created article

metaunknown required

Changes

No recorded changes to this operation across all 2 revisions of this API.