---
title: "Delete post"
method: DELETE
path: "/api/v1/post/{id}"
tags: ["post"]
---

# Delete post

`DELETE /api/v1/post/{id}`

## Path parameters

- `id` string, required

## Response `200`

200

- object
  - `id` string, required
  - `teamId` string, required
  - `organizationId` string, nullable
  - `title` string, required
  - `referenceKey` string, nullable
  - `postDate` string, date-time, nullable, required
  - `postedDate` string, date-time, nullable
  - `status` 'DRAFT' | 'SCHEDULED' | 'POSTED' | 'ERROR' | 'DELETED' | 'PROCESSING' | 'REVIEW' | 'RETRYING', required
  - `data` object, required
    - `TWITTER` object, nullable
      - `text` string, nullable
      - `uploadIds` string[], nullable
      - `replySettings` 'EVERYONE' | 'FOLLOWING' | 'MENTIONED_USERS' | 'SUBSCRIBERS' | 'VERIFIED', nullable
    - `PINTEREST` object, nullable
      - `text` string, nullable
      - `description` string, nullable
      - `boardName` string, required
      - `uploadIds` string[], nullable
      - `thumbnail` string, nullable — The URL to image uploaded on bundle.social.
      - `link` string, nullable — The URL to which the Pin will link to.
      - `altText` string, nullable — The alt text for the image. This is used by screen readers and when the image can't be loaded.
      - `note` string, nullable — A note about the Pin. This is not visible to the public.
      - `dominantColor` string, nullable — The dominant color of the image. This is used to display the image before it's loaded.
    - `FACEBOOK` object, nullable
      - `type` 'POST' | 'REEL' | 'STORY'
      - `text` string, nullable
      - `uploadIds` string[], nullable
      - `mediaItems` object[], nullable
        - `uploadId` string, required
        - `altText` string, nullable
      - `link` string, nullable — The URL to which the post will link to. Only available for type POST.
      - `thumbnail` string, nullable — The URL to image uploaded on bundle.social.
      - `mediaTitle` string, nullable — Title for video posts (type POST with video only, not REEL or STORY). This is displayed as the video title on Facebook.
      - `nativeScheduleTime` string, date-time, nullable — If passed, instead of publishing immediately, the post will be scheduled for the given date/time directly in Meta scheduler. Local date/time as ISO 8601 string max 30 days in the future.
    - `INSTAGRAM` object, nullable
      - `type` 'POST' | 'REEL' | 'STORY'
      - `text` string, nullable
      - `uploadIds` string[], nullable
      - `altText` string, nullable — Alternative text for a single image post.
      - `thumbnailOffset` number, nullable — Choose a frame of the published video as the cover photo in ms
      - `thumbnail` string, nullable — The URL to image uploaded on bundle.social.
      - `shareToFeed` boolean, nullable — For Reels only.When true, indicates that the reel can appear in both the Feed and Reels tabs.When false, indicates the reel can only appear in the Reels tab.
      - `collaborators` string[], nullable
      - `autoFitImage` boolean, nullable
      - `autoCropImage` boolean, nullable
      - `tagged` object[], nullable
        - `username` string, required
        - `x` number
        - `y` number
      - `carouselItems` object[], nullable
        - `uploadId` string, required
        - `altText` string, nullable
        - `tagged` object[], nullable
          - `username` string, required
          - `x` number, required
          - `y` number, required
      - `locationId` string, nullable
      - `trialParams` object, nullable — For Reels only. Trial reels are only shared to non-followers.
        - `graduationStrategy` 'MANUAL' | 'SS_PERFORMANCE', required
      - `musicSoundInfo` object, nullable — Information about the Instagram audio asset used for Reels publishing.
        - `musicSoundId` string, required — Use audio_id from Instagram Audio API search endpoint.
        - `musicSoundVolume` integer, nullable — Audio volume (0-100).
        - `videoOriginalSoundVolume` integer, nullable — Background volume of the original video sound (0-100).
    - `THREADS` object, nullable
      - `text` string, nullable
      - `uploadIds` string[], nullable
      - `mediaItems` object[], nullable
        - `uploadId` string, required
        - `altText` string, nullable
    - `TIKTOK` object, nullable
      - `type` 'VIDEO' | 'IMAGE'
      - `text` string, nullable
      - `uploadIds` string[], nullable
      - `thumbnail` string, nullable — The URL to image uploaded on bundle.social.
      - `privacy` 'SELF_ONLY' | 'PUBLIC_TO_EVERYONE' | 'MUTUAL_FOLLOW_FRIENDS' | 'FOLLOWER_OF_CREATOR', nullable
      - `photoCoverIndex` integer, nullable
      - `isBrandContent` boolean, nullable — Set to true if the video is a paid partnership to promote a third-party business.
      - `isOrganicBrandContent` boolean, nullable — Set to true if this video is promoting the creator's own business.
      - `disableComments` boolean, nullable — If set to true, other TikTok users will not be allowed to make comments on this post.
      - `disableDuet` boolean, nullable — If set to true, other TikTok users will not be allowed to make Stitches using this post.
      - `disableStitch` boolean, nullable — If set to true, other TikTok users will not be allowed to make Duets using this post.
      - `thumbnailOffset` number, nullable — Choose a frame of the published video as the cover photo in ms
      - `isAiGenerated` boolean, nullable — Set to true if this video is AI generated.
      - `autoAddMusic` boolean, nullable — If set to true, TikTok will automatically add music to the photos.
      - `autoScale` boolean, nullable
      - `uploadToDraft` boolean, nullable — If set to true, upload post as draft.
      - `musicSoundInfo` object, nullable — Information about the commercial sound (track) used for TikTok publishing.
        - `musicSoundId` string, required — Use song_clip_id from CML trending list (full_duration_song_clip or trending_song_clip).
        - `musicSoundVolume` integer, nullable — Commercial sound volume (0-100).
        - `musicSoundStart` integer, nullable — Starting point of the commercial sound in milliseconds.
        - `musicSoundEnd` integer, nullable — Ending point of the commercial sound in milliseconds.
        - `videoOriginalSoundVolume` integer, nullable — Background volume of the original video sound (0-100).
    - `LINKEDIN` object, nullable
      - `text` string, required
      - `uploadIds` string[], nullable
      - `link` string, nullable — Optional URL for LinkedIn article preview post.
      - `thumbnail` string, nullable — The URL to image uploaded on bundle.social.
      - `mediaTitle` string, nullable — Title for video or document posts. If not provided for videos, LinkedIn displays the posting date under the video.
      - `privacy` 'CONNECTIONS' | 'PUBLIC' | 'LOGGED_IN' | 'CONTAINER', nullable
      - `hideFromFeed` boolean, nullable — Set to true if the post shouldn't be displayed in the main feed.
      - `disableReshare` boolean, nullable — Set to true if the post is not allowed to be reshared.
    - `YOUTUBE` object, nullable
      - `type` 'VIDEO' | 'SHORT'
      - `uploadIds` string[], nullable
      - `text` string, nullable
      - `description` string, nullable
      - `thumbnail` string, nullable — The URL to image uploaded on bundle.social.
      - `privacy` 'PRIVATE' | 'PUBLIC' | 'UNLISTED', nullable
      - `defaultLanguage` string, nullable — BCP-47 language code for the video's title and description, e.g. "en" or "pl".
      - `defaultAudioLanguage` string, nullable — BCP-47 language code for the video's default audio track, e.g. "en" or "pl".
      - `madeForKids` boolean, nullable — Set to true if the video is made for kids.
      - `containsSyntheticMedia` boolean, nullable — Set to true if video contains AI generated content
      - `hasPaidProductPlacement` boolean, nullable — Set to true if video has paid product placement
    - `REDDIT` object, nullable
      - `sr` string, required — Subreddit name. Example: r/subredditName or u/username
      - `text` string, required
      - `description` string, nullable
      - `uploadIds` string[], nullable
      - `link` string, nullable — The URL to which the post will link to.
      - `nsfw` boolean, nullable — Set to true if the post is NSFW.
      - `flairId` string, nullable — Flair ID for the post. Required if the subreddit requires flair selection.
    - `DISCORD` object, nullable
      - `channelId` string, required
      - `text` string, nullable
      - `uploadIds` string[], nullable
      - `username` string, nullable — The username to display as the author of the message.
      - `avatarUrl` string, nullable — Avatar url to display as the author of the message.
    - `SLACK` object, nullable
      - `channelId` string, required
      - `text` string, nullable
      - `uploadIds` string[], nullable
      - `username` string, nullable — The username to display as the author of the message.
      - `avatarUrl` string, nullable — Avatar url to display as the author of the message.
    - `MASTODON` object, nullable
      - `text` string, nullable
      - `uploadIds` string[], nullable
      - `thumbnail` string, nullable — The URL to image uploaded on bundle.social.
      - `privacy` 'PUBLIC' | 'UNLISTED' | 'PRIVATE' | 'DIRECT', nullable
      - `spoiler` string, nullable
    - `BLUESKY` object, nullable
      - `text` string, nullable
      - `uploadIds` string[], nullable
      - `tags` string[], nullable — Extra hashtags (without #), up to 8.
      - `labels` string[], nullable — Self-labels (content warnings) applied to the post.
      - `quoteUri` string — AT-URI of the post to quote (e.g. at://did.../app.bsky.feed.post/<rkey>).
      - `externalUrl` string, uri, nullable — Target URL for the external link card
      - `externalTitle` string, nullable — Card title for the external link card
      - `externalDescription` string, nullable — Card description for the external link card
      - `thumbnail` string, uri, nullable — This should be URL to publicly available image uploaded to bundle.social account.
      - `videoAlt` string, nullable — Alt text for the video embed.
    - `GOOGLE_BUSINESS` object, nullable
      - `text` string, nullable
      - `uploadIds` string[], nullable — IDs of images/videos uploaded to bundle.social.
      - `topicType` 'STANDARD' | 'EVENT' | 'OFFER' | 'ALERT', nullable
      - `languageCode` string, nullable — Language tag like 'en' or 'en-US'.
      - `callToActionType` 'BOOK' | 'ORDER' | 'SHOP' | 'LEARN_MORE' | 'SIGN_UP' | 'CALL', nullable
      - `callToActionUrl` string, nullable
      - `eventTitle` string, nullable
      - `eventStartDate` string, date-time, nullable
      - `eventEndDate` string, date-time, nullable
      - `offerCouponCode` string, nullable
      - `offerRedeemOnlineUrl` string, nullable
      - `offerTermsConditions` string, nullable
      - `alertType` 'COVID_19', nullable — Alert type for ALERT posts.
    - `SNAPCHAT` object, nullable
      - `type` 'STORY' | 'SPOTLIGHT'
      - `uploadIds` string[], nullable
      - `text` string, nullable
      - `description` string, nullable
      - `locale` string, nullable
      - `skipSaveToProfile` boolean, nullable
  - `error` string, nullable
  - `errors` object, nullable
    - `TWITTER` string, nullable
    - `PINTEREST` string, nullable
    - `FACEBOOK` string, nullable
    - `INSTAGRAM` string, nullable
    - `TIKTOK` string, nullable
    - `LINKEDIN` string, nullable
    - `REDDIT` string, nullable
    - `DISCORD` string, nullable
    - `SLACK` string, nullable
    - `YOUTUBE` string, nullable
    - `MASTODON` string, nullable
    - `THREADS` string, nullable
    - `BLUESKY` string, nullable
    - `GOOGLE_BUSINESS` string, nullable
    - `SNAPCHAT` string, nullable
  - `errorsVerbose` object, nullable
    - `TWITTER` object, nullable
      - `code` string, nullable
      - `errorMessage` string, nullable
      - `isTransient` boolean, nullable
      - `retryability` 'retryable' | 'non_retryable' | 'unknown', nullable
      - `httpStatus` number, nullable
      - `meta` unknown
      - `userFacingMessage` string, nullable
    - `PINTEREST` object, nullable
      - `code` string, nullable
      - `errorMessage` string, nullable
      - `isTransient` boolean, nullable
      - `retryability` 'retryable' | 'non_retryable' | 'unknown', nullable
      - `httpStatus` number, nullable
      - `meta` unknown
      - `userFacingMessage` string, nullable
    - `FACEBOOK` object, nullable
      - `code` string, nullable
      - `errorMessage` string, nullable
      - `isTransient` boolean, nullable
      - `retryability` 'retryable' | 'non_retryable' | 'unknown', nullable
      - `httpStatus` number, nullable
      - `meta` unknown
      - `userFacingMessage` string, nullable
    - `INSTAGRAM` object, nullable
      - `code` string, nullable
      - `errorMessage` string, nullable
      - `isTransient` boolean, nullable
      - `retryability` 'retryable' | 'non_retryable' | 'unknown', nullable
      - `httpStatus` number, nullable
      - `meta` unknown
      - `userFacingMessage` string, nullable
    - `TIKTOK` object, nullable
      - `code` string, nullable
      - `errorMessage` string, nullable
      - `isTransient` boolean, nullable
      - `retryability` 'retryable' | 'non_retryable' | 'unknown', nullable
      - `httpStatus` number, nullable
      - `meta` unknown
      - `userFacingMessage` string, nullable
    - `LINKEDIN` object, nullable
      - `code` string, nullable
      - `errorMessage` string, nullable
      - `isTransient` boolean, nullable
      - `retryability` 'retryable' | 'non_retryable' | 'unknown', nullable
      - `httpStatus` number, nullable
      - `meta` unknown
      - `userFacingMessage` string, nullable
    - `REDDIT` object, nullable
      - `code` string, nullable
      - `errorMessage` string, nullable
      - `isTransient` boolean, nullable
      - `retryability` 'retryable' | 'non_retryable' | 'unknown', nullable
      - `httpStatus` number, nullable
      - `meta` unknown
      - `userFacingMessage` string, nullable
    - `DISCORD` object, nullable
      - `code` string, nullable
      - `errorMessage` string, nullable
      - `isTransient` boolean, nullable
      - `retryability` 'retryable' | 'non_retryable' | 'unknown', nullable
      - `httpStatus` number, nullable
      - `meta` unknown
      - `userFacingMessage` string, nullable
    - `SLACK` object, nullable
      - `code` string, nullable
      - `errorMessage` string, nullable
      - `isTransient` boolean, nullable
      - `retryability` 'retryable' | 'non_retryable' | 'unknown', nullable
      - `httpStatus` number, nullable
      - `meta` unknown
      - `userFacingMessage` string, nullable
    - `YOUTUBE` object, nullable
      - `code` string, nullable
      - `errorMessage` string, nullable
      - `isTransient` boolean, nullable
      - `retryability` 'retryable' | 'non_retryable' | 'unknown', nullable
      - `httpStatus` number, nullable
      - `meta` unknown
      - `userFacingMessage` string, nullable
    - `MASTODON` object, nullable
      - `code` string, nullable
      - `errorMessage` string, nullable
      - `isTransient` boolean, nullable
      - `retryability` 'retryable' | 'non_retryable' | 'unknown', nullable
      - `httpStatus` number, nullable
      - `meta` unknown
      - `userFacingMessage` string, nullable
    - `THREADS` object, nullable
      - `code` string, nullable
      - `errorMessage` string, nullable
      - `isTransient` boolean, nullable
      - `retryability` 'retryable' | 'non_retryable' | 'unknown', nullable
      - `httpStatus` number, nullable
      - `meta` unknown
      - `userFacingMessage` string, nullable
    - `BLUESKY` object, nullable
      - `code` string, nullable
      - `errorMessage` string, nullable
      - `isTransient` boolean, nullable
      - `retryability` 'retryable' | 'non_retryable' | 'unknown', nullable
      - `httpStatus` number, nullable
      - `meta` unknown
      - `userFacingMessage` string, nullable
    - `GOOGLE_BUSINESS` object, nullable
      - `code` string, nullable
      - `errorMessage` string, nullable
      - `isTransient` boolean, nullable
      - `retryability` 'retryable' | 'non_retryable' | 'unknown', nullable
      - `httpStatus` number, nullable
      - `meta` unknown
      - `userFacingMessage` string, nullable
    - `SNAPCHAT` object, nullable
      - `code` string, nullable
      - `errorMessage` string, nullable
      - `isTransient` boolean, nullable
      - `retryability` 'retryable' | 'non_retryable' | 'unknown', nullable
      - `httpStatus` number, nullable
      - `meta` unknown
      - `userFacingMessage` string, nullable
  - `externalData` object, nullable
    - `TWITTER` object, nullable
      - `id` string, nullable
      - `permalink` string, nullable
    - `PINTEREST` object, nullable
      - `id` string, nullable
      - `permalink` string, nullable
      - `thumbnail` string, nullable
    - `FACEBOOK` object, nullable
      - `id` string, nullable
      - `postId` string, nullable
      - `videoId` string, nullable
      - `permalink` string, nullable
      - `thumbnail` string, nullable
    - `INSTAGRAM` object, nullable
      - `id` string, nullable
      - `permalink` string, nullable
      - `thumbnail` string, nullable
    - `TIKTOK` object, nullable
      - `id` string, nullable
      - `shareId` string, nullable
      - `requestId` string, nullable
      - `permalink` string, nullable
      - `status` string, nullable
    - `LINKEDIN` object, nullable
      - `id` string, nullable
      - `activity` string, nullable
      - `permalink` string, nullable
      - `thumbnail` string, nullable
    - `REDDIT` object, nullable
      - `id` string, nullable
      - `permalink` string, nullable
      - `subreddit_name` string, nullable
    - `DISCORD` object, nullable
      - `id` string, nullable
      - `permalink` string, nullable
      - `channelId` string, nullable
    - `SLACK` object, nullable
      - `id` string, nullable
      - `permalink` string, nullable
      - `channelId` string, nullable
    - `YOUTUBE` object, nullable
      - `id` string, nullable
      - `permalink` string, nullable
      - `thumbnail` string, nullable
      - `sessionUri` string, nullable — YouTube resumable upload session URI for retry handling
    - `MASTODON` object, nullable
      - `id` string, nullable
      - `permalink` string, nullable
      - `thumbnail` string, nullable
    - `THREADS` object, nullable
      - `id` string, nullable
      - `permalink` string, nullable
    - `BLUESKY` object, nullable
      - `id` string, nullable
      - `uri` string, nullable
      - `cid` string, nullable — Content ID of the created record
      - `permalink` string, nullable
      - `did` string, nullable — Author DID (owner of the record)
    - `GOOGLE_BUSINESS` object, nullable
      - `id` string, nullable — Resource name of the Local Post, e.g. 'accounts/{accountId}/locations/{locationId}/localPosts/{postId}'.
      - `permalink` string, nullable — Public link to the post (searchUrl) when available.
    - `SNAPCHAT` object, nullable
      - `id` string, nullable
      - `mediaId` string, nullable
      - `type` 'STORY' | 'SPOTLIGHT', nullable
      - `profileId` string, nullable
      - `sourceUploadId` string, nullable
      - `permalink` string, nullable
      - `status` 'MEDIA_UPLOADED' | 'MEDIA_PROCESSING' | 'PUBLISHED', nullable
  - `retryCount` number, required
  - `createdAt` string, date-time, nullable, required
  - `updatedAt` string, date-time, nullable, required
  - `deletedAt` string, date-time, nullable

## Other responses

- `400` — 400
- `401` — 401
- `403` — 403
- `404` — 404
- `429` — 429
- `500` — 500

---

[API](https://skmtc.dev/bundle/apis/bundle-social-api.md) · [All operations](https://skmtc.dev/bundle/apis/bundle-social-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bundle/bundle-social-api/revisions/b773556c2f09/schema)