Posts

Update a post

Updates a post that is still pending. Two things can change:

• scheduled_at — reschedule (must be at least 1 minute in the future) or set to null to publish immediately. Only allowed while every item is still in pending state.

• items — replace the set of pending items. Items with item_id are updated in place, items without are inserted, and pending items not present in the body are deleted. Items that already finished publishing are never touched.

At least one of scheduled_at or items must be provided.

patch/posts/{id}

Request

  • Base URL: https://api.cut.pro/api/v1
  • URL: https://api.cut.pro/api/v1/posts/{id}
  • Auth: API key in header X-Api-Key

Path parameters

idstring required

Request body

scheduled_atstring nullable

ISO 8601 future timestamp, or null to clear the schedule and publish immediately.

Response

Response for status 200

idstring required
status'pending' | 'processing' | 'completed' | 'partial' | 'failed' | 'cancelled' required
scheduled_atstring nullable required
created_atstring required
updated_atstring required
item_countnumber required

Changes

No recorded changes to this operation across all 1 revision of this API.