> ## 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 Facebook post > Update a specific Facebook post by post ID. ## OpenAPI ````yaml api-reference/scheduler-openapi.json PATCH /facebook/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: /facebook/scheduled_posts/{post_id}: parameters: - description: The ID of the post to update in: path name: post_id required: true schema: minimum: 0 type: integer patch: tags: - facebook summary: Update a Facebook post description: Update a specific Facebook post by post ID. requestBody: content: application/json: schema: $ref: '#/components/schemas/FacebookScheduledPostPartial' required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/FacebookScheduledPost' description: OK '422': $ref: '#/components/responses/UNPROCESSABLE_ENTITY' default: $ref: '#/components/responses/DEFAULT_ERROR' components: schemas: FacebookScheduledPostPartial: properties: alt_text_media_map: description: Mapping for the alt text of each media in the post nullable: true type: object 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 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 cover_image_media: description: The media to be published as a FB Reel cover image readOnly: true type: object cover_image_media_id: description: The id of the media which will be published as a FB Reel cover image nullable: true type: integer 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 duplicate_to_brand_ids: description: The list of duplicate to brand ids. items: minimum: 0 type: integer maxItems: 55 type: array writeOnly: true first_comment: description: The first comment to be auto published for the post. maxLength: 8000 nullable: true type: string first_comment_status: enum: - SUCCESS - FAILED readOnly: true type: string 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 link: description: URL in the message to feature format: url nullable: true type: string link_preview: allOf: - $ref: '#/components/schemas/FacebookLinkPreview' description: Data related to the `link` field nullable: true live_post_url: description: Link to the live published post. format: url readOnly: true type: string location: allOf: - $ref: '#/components/schemas/FacebookLocation' description: Data related to the `location_id` field readOnly: true location_id: description: Facebook ID of the location shown in the post nullable: 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 message: description: Text content of the post type: string 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 post_type: description: Type of Facebook Post to be published enum: - POST - REEL type: string rss_feed_id: description: Foreign key reference to the RSS feed table. nullable: true type: integer rss_guid: description: The unique identifier coming from RSS Feed. nullable: true type: string rss_publish_date: description: The timestamp of when an RSS feed item was published format: date-time nullable: 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 subtitle_content: description: Raw SRT subtitle file content as text nullable: true type: string subtitle_error_message: description: Error message if subtitle upload failed nullable: true readOnly: true type: string subtitle_metadata: allOf: - $ref: '#/components/schemas/FacebookSubtitleMetadata' description: Subtitle metadata including language code and filename nullable: true type: object subtitle_upload_status: description: 'Computed status: SUCCESS if no error, FAILED if error exists' nullable: true readOnly: true type: string targeting: allOf: - $ref: '#/components/schemas/Targeting' description: Limit the audience of the post to these criteria nullable: true thumb_offset: description: Time offset in seconds from the video for the thumbnail nullable: true type: integer thumbnail_url: description: Image URL for the thumbnail to use format: url nullable: true type: string timestamp: description: The scheduled date & time for publishing the post. format: date-time nullable: true type: string title: description: Deprecated, use `video_title` nullable: true type: string updated_at: description: The time when the post was last updated. format: date-time readOnly: true type: string video_title: description: The title given to the attached video when opened nullable: true type: string type: object FacebookScheduledPost: properties: brand_id: description: The id of the brand to which the post belongs. minimum: 0 type: integer auto_publish: description: Whether the post should be auto published. type: boolean 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 post_type: description: Type of Facebook Post to be published enum: - POST - REEL type: string message: description: Text content of the post type: string media_ids: description: The list of the media ids attached to the post. items: minimum: 0 type: integer type: array timestamp: description: The scheduled date & time for publishing the post. format: date-time nullable: true type: string first_comment: description: The first comment to be auto published for the post. maxLength: 8000 nullable: true type: string link: description: URL in the message to feature format: url nullable: true type: string cover_image_media_id: description: The id of the media which will be published as a FB Reel cover image nullable: true type: integer location_id: description: Facebook ID of the location shown in the post nullable: true type: string thumb_offset: description: Time offset in seconds from the video for the thumbnail nullable: true type: integer video_title: description: The title given to the attached video when opened nullable: true type: string targeting: allOf: - $ref: '#/components/schemas/Targeting' description: Limit the audience of the post to these criteria nullable: true alt_text_media_map: description: Mapping for the alt text of each media in the post nullable: true type: object 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_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 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 cover_image_media: description: The media to be published as a FB Reel cover image readOnly: true type: object 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 duplicate_to_brand_ids: description: The list of duplicate to brand ids. items: minimum: 0 type: integer maxItems: 55 type: array writeOnly: true first_comment_status: enum: - SUCCESS - FAILED readOnly: true type: string 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 link_preview: allOf: - $ref: '#/components/schemas/FacebookLinkPreview' description: Data related to the `link` field nullable: true live_post_url: description: Link to the live published post. format: url readOnly: true type: string location: allOf: - $ref: '#/components/schemas/FacebookLocation' description: Data related to the `location_id` field readOnly: true media: description: The list of media attached to the post. items: type: object readOnly: true type: array 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 rss_feed_id: description: Foreign key reference to the RSS feed table. nullable: true type: integer rss_guid: description: The unique identifier coming from RSS Feed. nullable: true type: string rss_publish_date: description: The timestamp of when an RSS feed item was published format: date-time nullable: true type: string sort_index: description: The sorted index for unscheduled posts. type: number source_id: nullable: true readOnly: true type: string subtitle_content: description: Raw SRT subtitle file content as text nullable: true type: string subtitle_error_message: description: Error message if subtitle upload failed nullable: true readOnly: true type: string subtitle_metadata: allOf: - $ref: '#/components/schemas/FacebookSubtitleMetadata' description: Subtitle metadata including language code and filename nullable: true type: object subtitle_upload_status: description: 'Computed status: SUCCESS if no error, FAILED if error exists' nullable: true readOnly: true type: string thumbnail_url: description: Image URL for the thumbnail to use format: url nullable: true type: string title: description: Deprecated, use `video_title` nullable: true type: string updated_at: description: The time when the post was last updated. format: date-time readOnly: true type: string required: - post_type 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 FacebookLinkPreview: properties: can_edit: description: Will be set to true if the link preview can be edited. readOnly: true type: boolean description: description: A one to two sentence description of the link. nullable: true type: string image: description: An image URL which should represent the link. format: url readOnly: true type: string image_media_id: description: >- A library-backend media ID of type IMAGE which should represent the link. Setting this value to null will clear any assigned image and ensure the original image scraped from Facebook will be returned. nullable: true type: integer title: description: The title of the link. maxLength: 255 nullable: true type: string url: description: The link preview URL. format: url readOnly: true type: string type: object FacebookLocation: properties: id: description: Facebook ID of the location type: string is_verified: description: Verified by Facebook type: boolean link: description: URL of the location in facebook-backend type: string location: description: >- Location object as returned from Facebook. See https://developers.facebook.com/docs/graph-api/reference/location/ type: object name: description: Name of the location type: string type: object FacebookSubtitleMetadata: properties: filename: description: Original filename of the subtitle file type: string language_code: description: 'Language code for subtitle (Facebook format: en_US, fr_CA)' enum: - af_ZA - ar_AR - ay_BO - az_AZ - be_BY - bg_BG - bn_IN - bs_BA - ca_ES - ck_US - cs_CZ - cx_PH - cy_GB - da_DK - de_DE - el_GR - en_GB - en_IN - en_US - eo_EO - es_CL - es_CO - es_ES - es_LA - es_MX - es_VE - et_EE - eu_ES - fa_IR - fi_FI - fo_FO - fr_CA - fr_FR - fy_NL - ga_IE - gl_ES - gn_PY - gu_IN - gx_GR - he_IL - hi_IN - hr_HR - hu_HU - hy_AM - id_ID - is_IS - it_IT - ja_JP - jv_ID - ka_GE - kk_KZ - km_KH - kn_IN - ko_KR - ku_TR - la_VA - li_NL - lt_LT - lv_LV - mg_MG - mk_MK - ml_IN - mn_MN - mr_IN - ms_MY - mt_MT - nb_NO - ne_NP - nl_BE - nl_NL - nn_NO - pa_IN - pl_PL - ps_AF - pt_BR - pt_PT - qu_PE - rm_CH - ro_RO - ru_RU - sa_IN - se_NO - sk_SK - sl_SI - so_SO - sq_AL - sr_RS - sv_SE - sw_KE - sy_SY - ta_IN - te_IN - tg_TJ - th_TH - tl_PH - tr_TR - tt_RU - uk_UA - ur_PK - uz_UZ - vi_VN - xh_ZA - yi_DE - zh_CN - zh_HK - zh_TW - zu_ZA type: string required: - language_code type: object Targeting: additionalProperties: false properties: geo_locations: allOf: - $ref: '#/components/schemas/TargetingLocations' description: Locations to limit the post towards 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 TargetingLocations: additionalProperties: false properties: countries: description: List of ISO 3166-1 codes of targeted countries items: maxLength: 2 minLength: 2 type: string type: array 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 ````