> ## Documentation Index
> Fetch the complete documentation index at: https://developer.dashsocial.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update a TikTok post

> Update a specific TikTok post by post ID.



## OpenAPI

````yaml api-reference/scheduler-openapi.json PATCH /tiktok/scheduled_posts/{post_id}
openapi: 3.0.2
info:
  contact:
    email: support@dashsocial.com
    name: Dash Hudson
    url: https://dashsocial.com
  description: >-
    Manage Scheduler content, links, analytics and more in the Dash Hudson
    platform.
  title: Dash Hudson Scheduler Backend Service
  version: 1.0.0
  x-logo:
    altText: Dash Hudson logo
    href: https://developer.dashsocial.com
    url: https://developer.dashsocial.com/assets/logo.svg
servers:
  - url: https://scheduler.dashsocial.com
security:
  - BearerAuth: []
tags:
  - description: ''
    name: approval_requests
  - description: ''
    name: bluesky
  - description: ''
    name: events
  - description: ''
    name: facebook
  - description: >-
      APIs for creating, scheduling, and retrieving posts to be shown on
      Instagram Posts.
    name: instagram
  - description: ''
    name: linkedin
  - description: ''
    name: pinterest
  - description: Endpoints for recommended publish times
    name: publish_times
  - description: ''
    name: rss_feeds
  - description: ''
    name: snapchat
  - description: ''
    name: threads
  - description: ''
    name: tiktok
  - description: ''
    name: twitter
  - description: ''
    name: youtube
paths:
  /tiktok/scheduled_posts/{post_id}:
    parameters:
      - description: The ID of the scheduled post to update
        in: path
        name: post_id
        required: true
        schema:
          minimum: 0
          type: integer
    patch:
      tags:
        - tiktok
      summary: Update a TikTok post
      description: Update a specific TikTok post by post ID.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TikTokScheduledPostPartial'
        required: true
      responses:
        '422':
          $ref: '#/components/responses/UNPROCESSABLE_ENTITY'
        default:
          $ref: '#/components/responses/DEFAULT_ERROR'
components:
  schemas:
    TikTokScheduledPostPartial:
      properties:
        approval_policy:
          description: The approval policy of the approval request
          enum:
            - APPROVAL_REQUIRED
            - APPROVAL_NOT_REQUIRED
          type: string
        approval_requests:
          description: The list of approval requests associated with the post.
          items:
            $ref: '#/components/schemas/ApprovalRequest'
          type: array
        approval_status:
          description: The approval status of the post.
          readOnly: true
          type: string
        auto_publish:
          description: Whether the post should be auto published.
          type: boolean
        auto_publish_error:
          enum:
            - ACCOUNT_RESTRICTED
            - AGAINST_COMMUNITY_STANDARDS
            - APPROVED_PUBLISHING_DATES_HAVE_NO_OVERLAP
            - AUTO_PUBLISH_LIMIT_EXCEEDED
            - DUPLICATE_POST
            - FLAGGED_AS_SPAM
            - INTERNAL
            - INVALID_ACCOUNT_TYPE
            - INVALID_AUTH
            - INVALID_DESCRIPTION
            - INVALID_IMAGE
            - INVALID_PIN_BOARD
            - INVALID_PRODUCT_TAGS
            - INVALID_TARGETING
            - INVALID_TITLE
            - INVALID_VIDEO_THUMBNAIL
            - MEDIA_CONTAINER_EXPIRED
            - MISSING_AUTH
            - OUTSIDE_OF_APPROVED_PUBLISHING_DATES
            - PAGE_PUBLISHING_AUTH_REQUIRED
            - PLATFORM_ERROR
            - REJECTED
            - TEXT_LENGTH_EXCEEDED
          readOnly: true
          type: string
        board_ids:
          description: The list of the board ids associated with the post.
          items:
            minimum: 0
            type: integer
          type: array
        branded_content_type:
          description: Branded content type of the TikTok post.
          enum:
            - promoted
            - paid_partnership
            - null
          nullable: true
          type: string
        callback_socket_id:
          type: string
        campaign_ids:
          description: The list of the campaign ids associated with the post.
          items:
            minimum: 0
            type: integer
          type: array
        content_tag_ids:
          description: The list of the content tag ids associated with the post.
          items:
            minimum: 0
            type: integer
          type: array
        created_at:
          description: The time when the post was created.
          format: date-time
          readOnly: true
          type: string
        creation_source:
          description: To identify the user or the application that created the post.
          enum:
            - RSS_FEED
          type: string
        disable_comment:
          default: false
          description: Whether to allow comments on the post
          type: boolean
        disable_duet:
          default: false
          description: Whether to allow others to duet the post
          type: boolean
        disable_stitch:
          default: false
          description: Whether to allow others to stitch with the post
          type: boolean
        duplicate_to_brand_ids:
          description: The list of duplicate to brand ids.
          items:
            minimum: 0
            type: integer
          maxItems: 55
          type: array
          writeOnly: true
        has_scheduled_time:
          description: Indicates if the post has a scheduled timestamp
          readOnly: true
          type: boolean
        id:
          description: A unique id for the post.
          minimum: 0
          readOnly: true
          type: integer
        live_post_url:
          description: Link to the live published post.
          format: url
          readOnly: true
          type: string
        media:
          description: The list of media attached to the post.
          items:
            type: object
          readOnly: true
          type: array
        media_ids:
          description: The list of the media ids attached to the post.
          items:
            minimum: 0
            type: integer
          type: array
        music_info:
          allOf:
            - $ref: '#/components/schemas/TiktokMusicInfo'
          default: null
          description: >-
            Trending sound data for the TikTok post. Null if no trending sound
            is selected.
          nullable: true
          type: object
        num_of_approvals_required:
          description: The number of approvals required to approve the request.
          readOnly: true
          type: integer
        post_group_id:
          description: The id of the post group associated with the post.
          format: uuid
          type: string
        share_id:
          readOnly: true
          type: string
        sort_index:
          description: The sorted index for unscheduled posts.
          type: number
        source_id:
          nullable: true
          readOnly: true
          type: string
        status:
          description: The current status of the post.
          enum:
            - AUTOPUBLISHING
            - DRAFT
            - EXPIRED
            - FAILED
            - IMPORTED
            - MISSING_APPROVALS
            - PARTIALLY_FAILED
            - POSTED
            - SCHEDULED
            - SKIPPED
            - USERS_NOTIFIED
          type: string
        text:
          description: The text of the post.
          type: string
        thumbnail_offset:
          description: Thumbnail offset in milliseconds
          minimum: 0
          nullable: true
          type: integer
        thumbnail_url:
          description: Image URL to be displayed as a thumbnail in the DH user interface.
          format: url
          nullable: true
          type: string
        timestamp:
          description: The scheduled date & time for publishing the post.
          format: date-time
          nullable: true
          type: string
        title:
          default: null
          nullable: true
          type: string
        tt_media_publish_complete_at:
          format: date-time
          readOnly: true
          type: string
        tt_post_removed_at:
          format: date-time
          readOnly: true
          type: string
        updated_at:
          description: The time when the post was last updated.
          format: date-time
          readOnly: true
          type: string
      type: object
    ApprovalRequest:
      properties:
        approval_status:
          description: The status of the approval request.
          enum:
            - PENDING
            - APPROVED
            - UNASSIGNED
          readOnly: true
          type: string
        brand_id:
          description: ID of the brand to which the approval request belongs to
          readOnly: true
          type: integer
        created_at:
          description: The time when the approval request was created.
          format: date-time
          readOnly: true
          type: string
        deleted_at:
          description: The time when the approval request was deleted.
          format: date-time
          readOnly: true
          type: string
        id:
          description: The unique ID of the approval request record.
          readOnly: true
          type: integer
        post_id:
          description: The ID of the post to which the approval request belongs to.
          readOnly: true
          type: integer
        post_platform:
          description: The platform for which the approval belongs to.
          enum:
            - instagram
            - facebook
            - tiktok
            - pinterest
            - twitter
            - linkedin
            - bluesky
            - threads
            - youtube
            - snapchat
          readOnly: true
          type: string
        requested_by_user_id:
          description: The user who requested the approval.
          type: integer
        review_user_id:
          description: The user who is being asked to approve the request.
          type: integer
        updated_at:
          description: The time when the approval request was last updated.
          format: date-time
          readOnly: true
          type: string
      type: object
    TiktokMusicInfo:
      properties:
        artist:
          description: Artist name
          type: string
        commercial_music_id:
          description: TikTok CML sound ID
          type: string
        commercial_music_name:
          description: Display name of the sound
          type: string
        music_sound_end:
          description: End position in the song (milliseconds)
          minimum: 0
          type: integer
        music_sound_start:
          description: Start position in the song (milliseconds)
          minimum: 0
          type: integer
        music_sound_volume:
          description: Volume level for the trending sound (0-100)
          maximum: 100
          minimum: 0
          type: integer
        thumbnail_url:
          description: Album art / sound thumbnail
          type: string
        trending_song_clip_duration:
          description: Trending song clip duration in seconds
          minimum: 1
          type: integer
        trending_song_clip_id:
          description: The trending song's clip ID used as music_sound_id at publish
          type: string
        trending_song_preview_url:
          description: Audio preview URL for the trending song clip
          type: string
        video_original_sound_volume:
          description: Volume level for the video's original audio (0-100)
          maximum: 100
          minimum: 0
          type: integer
      required:
        - artist
        - commercial_music_id
        - commercial_music_name
        - music_sound_end
        - music_sound_start
        - music_sound_volume
        - thumbnail_url
        - trending_song_clip_duration
        - trending_song_clip_id
        - trending_song_preview_url
        - video_original_sound_volume
      type: object
    Error:
      properties:
        code:
          description: Error code
          type: integer
        errors:
          description: Errors
          type: object
        message:
          description: Error message
          type: string
        status:
          description: Error name
          type: string
      type: object
  responses:
    UNPROCESSABLE_ENTITY:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
      description: Unprocessable Entity
    DEFAULT_ERROR:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
      description: Default error response
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API key from Dash Social developer settings

````