---
title: "Get post"
method: GET
path: "/v1/posts/{draft_id}"
tags: ["Drafts"]
---

# Get post

`GET /v1/posts/{draft_id}`

Retrieve a post by ID.

## Path parameters

- `draft_id` integer, required

## Response `200`

OK

- DraftDetailResponse — Response schema for draft creation and retrieval
  - `id` integer, required — Unique identifier for the draft
  - `social_set_id` integer, required — ID of the social set (account) this draft belongs to
  - `draft_id` integer, required — Deprecated: Use 'id' instead. Unique identifier for the draft.
  - `status` 'draft' | 'scheduled' | 'published' | 'publishing' | 'error', required — Current status of the draft. 'draft' = saved but not scheduled, 'scheduled' = queued for publishing, 'published' = successfully posted, 'publishing' = currently being posted, 'error' = publishing failed
  - `created_at` string, date-time, required — Timestamp when the draft was created (ISO 8601 format in UTC)
  - `updated_at` string, date-time, nullable — Timestamp when the draft was last edited (ISO 8601 format in UTC). Null if never edited.
  - `scheduled_date` string, date-time, nullable — Timestamp when the draft is scheduled to publish (ISO 8601 format in UTC). Null if not scheduled.
  - `published_at` string, date-time, nullable — Timestamp when the draft was published on any enabled platform (ISO 8601 format in UTC). Null if not yet published.
  - `draft_title` string, nullable — Human-readable title for the draft. This is for internal organization only and is not posted to social media.
  - `tags` string[] — List of tag slugs (not names) associated with this draft. Use the /tags endpoint to get available tags with their slugs.
  - `preview` string, required — Text preview of the draft (first 180 characters)
  - `share_url` string, nullable — Public share URL for the draft. Null if the draft is not publicly shared.
  - `private_url` string, required — Private URL for accessing the draft in Postey. Can be shared with team members without requiring public sharing.
  - `platforms` PlatformsResponse, required — Schema for platform configurations in responses (no validation limits)
    - `x` union — X (Twitter) configuration
      - EnabledXPlatformResponse — Enabled X platform for responses (no validation limits)
        - `enabled` true, required
        - `posts` Post[], required — List of posts for this platform
          - `text` string, required — The text content of the post
          - `media_ids` string[] — List of media IDs to attach to the post. Obtain media IDs by uploading files via the media upload endpoint.
        - `settings` XSettings — Settings specific to X (Twitter)
          - `reply_to_url` string, nullable — URL of the X post to reply to. When provided, the first post in your thread will be posted as a reply.
          - `community_id` string, nullable — ID of the X community to post to. Find the ID in the community URL (e.g., x.com/i/communities/1493446837214187523). You must have permission to post to the community, otherwise publishing will fail.
          - `share_with_followers` boolean, nullable — When posting to a community, whether to also share the post to your timeline/followers. Defaults to true if not specified. Only has an effect when community_id is provided.
      - DisabledPlatform — Shared schema for all disabled platforms
        - `enabled` false, required
    - `linkedin` union — LinkedIn configuration
      - EnabledLinkedInPlatformResponse — Enabled LinkedIn platform for responses (no validation limits)
        - `enabled` true, required
        - `posts` Post[], required — List of posts for this platform
          - `text` string, required — The text content of the post
          - `media_ids` string[] — List of media IDs to attach to the post. Obtain media IDs by uploading files via the media upload endpoint.
        - `settings` LinkedInSettings — Settings specific to LinkedIn
      - DisabledPlatform — Shared schema for all disabled platforms
        - `enabled` false, required
    - `mastodon` union — Mastodon configuration
      - EnabledMastodonPlatformResponse — Enabled Mastodon platform for responses (no validation limits)
        - `enabled` true, required
        - `posts` Post[], required — List of posts for this platform
          - `text` string, required — The text content of the post
          - `media_ids` string[] — List of media IDs to attach to the post. Obtain media IDs by uploading files via the media upload endpoint.
        - `settings` MastodonSettings — Settings specific to Mastodon
      - DisabledPlatform — Shared schema for all disabled platforms
        - `enabled` false, required
    - `threads` union — Threads configuration
      - EnabledThreadsPlatformResponse — Enabled Threads platform for responses (no validation limits)
        - `enabled` true, required
        - `posts` Post[], required — List of posts for this platform
          - `text` string, required — The text content of the post
          - `media_ids` string[] — List of media IDs to attach to the post. Obtain media IDs by uploading files via the media upload endpoint.
        - `settings` ThreadsSettings — Settings specific to Threads
      - DisabledPlatform — Shared schema for all disabled platforms
        - `enabled` false, required
    - `bluesky` union — Bluesky configuration
      - EnabledBlueskyPlatformResponse — Enabled Bluesky platform for responses (no validation limits)
        - `enabled` true, required
        - `posts` Post[], required — List of posts for this platform
          - `text` string, required — The text content of the post
          - `media_ids` string[] — List of media IDs to attach to the post. Obtain media IDs by uploading files via the media upload endpoint.
        - `settings` BlueskySettings — Settings specific to Bluesky
      - DisabledPlatform — Shared schema for all disabled platforms
        - `enabled` false, required
  - `x_published_url` string, nullable — URL of the published post on X (Twitter). Null if not published to X or URL not available.
  - `linkedin_published_url` string, nullable — URL of the published post on LinkedIn. Null if not published to LinkedIn or URL not available.
  - `x_post_published_at` string, date-time, nullable — Timestamp when the post was published to X (ISO 8601 format in UTC). Null if not published to X.
  - `linkedin_post_published_at` string, date-time, nullable — Timestamp when the post was published to LinkedIn (ISO 8601 format in UTC). Null if not published to LinkedIn.
  - `mastodon_post_published_at` string, date-time, nullable — Timestamp when the post was published to Mastodon (ISO 8601 format in UTC). Null if not published to Mastodon.
  - `threads_post_published_at` string, date-time, nullable — Timestamp when the post was published to Threads (ISO 8601 format in UTC). Null if not published to Threads.
  - `bluesky_post_published_at` string, date-time, nullable — Timestamp when the post was published to Bluesky (ISO 8601 format in UTC). Null if not published to Bluesky.
  - `scratchpad_text` string, nullable — Plain text scratchpad notes for the draft. Formatting is stripped.

## Other responses

- `403` — Insufficient permissions
- `404` — Resource not found
- `429` — Rate limited

---

[API](https://skmtc.dev/raycast/apis/postey-public-api.md) · [All operations](https://skmtc.dev/raycast/apis/postey-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/raycast/postey-public-api/revisions/65807802627f/schema)