> ## Documentation Index > Fetch the complete documentation index at: https://docs.superx.so/llms.txt > Use this file to discover all available pages before exploring further. # List drafts and scheduled posts ## OpenAPI ````yaml /api-reference/openapi.yaml get /v1/scheduled-posts openapi: 3.1.0 info: title: SuperX API version: 1.0.0 description: > The SuperX public API: your Twitter/X content, analytics, audience and scheduling data over REST. All endpoints require an API key (`Authorization: Bearer sxk_...`) except `GET /v1/docs`. Keys are created in the SuperX app under Account > API / MCP / CLI and are server-side secrets. Timestamps are UTC ISO-8601 in both directions; inputs must carry an explicit `Z` or numeric offset. Every authenticated response carries `X-RateLimit-Limit`, `X-RateLimit-Remaining` and `X-RateLimit-Reset` headers. contact: name: SuperX url: https://superx.so servers: - url: https://api.superx.so security: - apiKey: [] tags: - name: Identity - name: Content - name: Analytics - name: Inspiration - name: Audience - name: Contact Lists - name: Signals - name: Media - name: Scheduling - name: Tags - name: Context - name: Queue - name: Articles - name: Meta paths: /v1/scheduled-posts: get: tags: - Scheduling summary: List drafts and scheduled posts operationId: listScheduledPosts parameters: - $ref: '#/components/parameters/AccountId' - name: status in: query description: >- Comma list of statuses to include. Default is all four. `draft` also covers legacy board drafts stored under internal statuses; they come back as `"draft"`. schema: type: string example: scheduled,draft - name: tags in: query description: >- Comma list of tag ids (from `GET /v1/tags`). Returns posts carrying ANY of the listed tags. schema: type: string example: V1StGXR8_Z5jdHi6B-myT - name: from in: query description: >- Include posts scheduled at or after this UTC ISO-8601 time (explicit Z or offset required). schema: type: string format: date-time - name: to in: query description: >- Include posts scheduled at or before this UTC ISO-8601 time (explicit Z or offset required). schema: type: string format: date-time - $ref: '#/components/parameters/Limit' - $ref: '#/components/parameters/Page' responses: '200': description: A page of scheduled posts and drafts. headers: X-RateLimit-Limit: $ref: '#/components/headers/X-RateLimit-Limit' X-RateLimit-Remaining: $ref: '#/components/headers/X-RateLimit-Remaining' X-RateLimit-Reset: $ref: '#/components/headers/X-RateLimit-Reset' content: application/json: schema: type: object properties: data: type: array items: $ref: '#/components/schemas/ScheduledPost' pagination: $ref: '#/components/schemas/Pagination' example: data: - id: V1StGXR8_Z5jdHi6B-myT status: scheduled scheduled_for: '2026-07-08T15:00:00.000Z' parts: - text: 'Shipping day. Here is everything new in this release:' - text: 1. A public API. Docs at docs.superx.so title: null scratchpad: null tags: [] created_at: '2026-07-06T09:30:00.000Z' - id: Fq2xWnA0kLpR7sVtYu3zc status: draft scheduled_for: null parts: - text: >- Rough idea: why most scheduling tools get threads wrong. title: Threads take scratchpad: null tags: - id: aB3xWnA0kLpR7sVtYu3zc name: Launch week color: amber created_at: '2026-07-05T20:11:00.000Z' pagination: page: 1 limit: 20 has_more: false total: 2 '400': $ref: '#/components/responses/InvalidParameter' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/SubscriptionRequired' '404': $ref: '#/components/responses/AccountNotFound' '429': $ref: '#/components/responses/RateLimited' '502': $ref: '#/components/responses/UpstreamError' '503': $ref: '#/components/responses/UpstreamUnavailable' components: parameters: AccountId: name: account_id in: query required: false description: >- Account to act on, from `GET /v1/accounts`. Defaults to your main account. An id outside your accounts returns `404 account_not_found`. schema: type: string Limit: name: limit in: query required: false description: Page size, 1 to 100. schema: type: integer minimum: 1 maximum: 100 default: 20 Page: name: page in: query required: false description: 1-based page number. schema: type: integer minimum: 1 default: 1 headers: X-RateLimit-Limit: description: The limit of the rate window closest to exhaustion. schema: type: integer X-RateLimit-Remaining: description: Requests remaining in that window. schema: type: integer X-RateLimit-Reset: description: Unix timestamp (seconds) when that window resets. schema: type: integer schemas: ScheduledPost: type: object properties: id: type: string status: type: string enum: - draft - scheduled - sent - error scheduled_for: type: string format: date-time nullable: true description: Null for drafts. parts: type: array items: type: object properties: text: type: string media: type: array description: Present only when the part carries media. items: type: object properties: object_key: type: string description: Re-use this on PATCH to keep the attachment. url: type: string file_type: type: string size: type: integer nullable: true alt_text: type: string nullable: true title: type: string nullable: true description: Draft title shown in the SuperX app. Never posted. scratchpad: type: string nullable: true description: Private working notes. Never posted. tags: type: array items: type: object properties: id: type: string name: type: string color: type: string created_at: type: string format: date-time nullable: true auto_retweet: type: object nullable: true description: Applied auto-retweet setting; null when off. properties: after_hours: type: integer nullable: true remove_after_hours: type: integer nullable: true auto_delete: type: object nullable: true description: Applied auto-delete setting; null when off. properties: after_hours: type: integer nullable: true threshold: type: integer nullable: true auto_plug: type: object nullable: true description: Applied auto-plug setting; null when off. properties: template_id: type: string nullable: true threshold: type: integer nullable: true auto_dm: type: object nullable: true description: >- Applied Auto DM setting (inherit-only, read-only); null when off. The DM text stays in the SuperX app. properties: enabled: type: boolean max_dms: type: integer nullable: true batch_mode: type: boolean triggers: type: object properties: reply: type: boolean retweet: type: boolean super_followers_only: type: boolean Pagination: type: object required: - page - limit - has_more properties: page: type: integer limit: type: integer has_more: type: boolean total: type: integer description: Present only where cheap to compute. ErrorEnvelope: type: object required: - error properties: error: type: object required: - code - message properties: code: type: string description: Stable machine-readable error code. message: type: string retry_after: type: integer description: Seconds to wait before retrying (rate-limit errors only). LegacyErrorEnvelope: type: object required: - error description: | Legacy shape used ONLY by the shared subscription middleware: a plain string `error` field. Seen on `403` when the subscription has lapsed (string starts with "subscription_required:") and on `500` when subscription verification fails (string starts with "internal_error:"). properties: error: type: string example: >- subscription_required: The SuperX API requires an active subscription responses: InvalidParameter: description: A parameter is missing, malformed, or out of range. content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' example: error: code: invalid_parameter message: since must be a UTC ISO-8601 timestamp Unauthorized: description: >- Missing/malformed Authorization header (`unauthorized`) or an unknown/revoked key (`invalid_api_key`). content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' example: error: code: invalid_api_key message: Unknown or revoked API key SubscriptionRequired: description: | Subscription lapsed. NOTE the legacy body shape: `error` is a plain string here, not the `{ code, message }` object. Read-only keys on write endpoints instead get the object envelope with code `insufficient_scope`. content: application/json: schema: oneOf: - $ref: '#/components/schemas/LegacyErrorEnvelope' - $ref: '#/components/schemas/ErrorEnvelope' example: error: >- subscription_required: The SuperX API requires an active subscription AccountNotFound: description: account_id is not one of your accounts. content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' example: error: code: account_not_found message: No account with that id belongs to this key RateLimited: description: Rate limit exceeded (limits vary by plan). Honor Retry-After. headers: Retry-After: description: Seconds to wait before retrying. schema: type: integer X-RateLimit-Limit: $ref: '#/components/headers/X-RateLimit-Limit' X-RateLimit-Remaining: $ref: '#/components/headers/X-RateLimit-Remaining' X-RateLimit-Reset: $ref: '#/components/headers/X-RateLimit-Reset' content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' example: error: code: rate_limited message: >- Rate limit exceeded for the Pro plan (30 requests/min). Upgrade for higher limits. retry_after: 42 UpstreamError: description: A dependent SuperX service returned an unexpected response. content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' example: error: code: upstream_error message: Failed to fetch scheduled posts. Try again shortly. UpstreamUnavailable: description: >- The scheduling service is temporarily unreachable. Safe to retry; reuse your Idempotency-Key on POST. content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' example: error: code: upstream_unavailable message: >- The scheduling service is temporarily unavailable. Retry with the same Idempotency-Key. securitySchemes: apiKey: type: http scheme: bearer description: >- A SuperX API key ("sxk_..."), created in the SuperX app under Account > API / MCP / CLI. Keys are server-side secrets. ````