Schedule social media posts from ChatGPT

Returns connected account IDs, workspace timezone, publishing opt-in and content pillars. Provider credentials are not included.

Returns caption, media and account requirements for each platform. With an account ID, returns the live limits for that account.

Creates a post, saved as a draft by default. Setting scheduled_at schedules public publication; publish_now publishes to the connected networks immediately. Timestamps require an ISO-8601 offset. Not idempotent: each call creates a new post.

Updates an existing unpublished post; omitted fields are preserved. Changing scheduled_at changes when it publishes publicly; publish_now publishes it immediately. Not idempotent when publish_now is set.

Tailor captions per selected platform or account. Keys are platform names or platform:account_id. Other post fields are preserved.

Read-only dry run of publish-time validation. Leaves nothing behind: no saved post, reserved quota, upload, schedule or publication. Runs the real validation path inside a rolled-back transaction and returns structured platform, field, code, message and blocking issues. Takes existing media IDs.

Schedules a post for future public publication. The timestamp must contain Z or an explicit timezone offset. Validates content, media and quota before scheduling. Idempotent for the same post and timestamp.

Immediately publishes an existing post to its connected networks. Requires the workspace agent publishing opt-in; API keys also need the publish:now ability.

List posts in the authorized workspace with bounded pagination. Returns UTC timestamps and workspace timezone.

Read one post and its account-specific captions, publication state and validation warnings.

Permanently deletes a draft or scheduled post. Published posts, partially published posts and posts currently publishing cannot be deleted.

Imports media into the media library from a public HTTPS URL, or from base64 data up to 3 MiB decoded. Returns a media ID for use in posts. Media counts toward the storage quota until deleted. Redirects and private-network URLs are rejected.

Imports an image or video attached to or generated in a ChatGPT conversation into the media library, using the file reference ChatGPT supplies. Returns a media ID for use in posts.

Shows an upload widget where the user picks images or videos from their device into the media library, for files without a public URL. The widget reports the new media IDs in the conversation. The result also includes an upload_url that opens the same uploader in a browser, for clients that cannot display widgets.

Lists workspace media IDs with temporary signed preview URLs that expire after five minutes.

Summarize post performance for a date range: totals compared with the previous period, daily changes, results by content format and the top posts. Numbers appear about 24 hours after a post goes live and refresh daily. Some platforms report only some metrics, so a zero can mean not reported.

Lists lifetime metrics per published post on connected accounts, including posts made outside PostQuest. Limited to the plan history. Sortable by metric.

Read one post's lifetime metrics and its day-by-day history: the cumulative totals on each day and how much each grew since the day before.

Queues a refresh of post metrics from the connected platforms. Analytics also sync automatically every 24 hours. Limited to once every 15 minutes per workspace; results arrive within a few minutes.