Move a plan's dates

Move a plan awaiting approval to new dates in one step: start and end (YYYY-MM-DD) become the plan's launch window and the campaign's dates, and every creator's post date moves with them, keeping its place in the window (a post three days in stays three days in) and pulled inside the new window when it is shorter. Both happen or neither does. start is today or later, end is on or after start, at most a year apart (conflict, reason bad_dates); two posts by one creator that would land on the same day are refused (conflict, reason same_day) and nothing moves; a signed plan or one the team wrote is refused (conflict, reason plan_signed). Prices do not change. Returns lines_moved and the plan as plan_quote returns it. Needs an idempotency_key. Scope: campaigns:write. MCP tool: plan_move_dates.

post/plans/{id}/dates

Request

  • Base URL: https://app.distribution.tech/api/v1
  • URL: https://app.distribution.tech/api/v1/plans/{id}/dates
  • Auth: HTTP bearer

Path parameters

idstring uuid required

Headers

Idempotency-Keystring required

8 to 128 letters, digits or . _ : -. Retry with the same key and the same request to get the same answer; it never runs twice.

Request body

startstring date required

The new first day, YYYY-MM-DD, today or later.

endstring date required

The new last day, YYYY-MM-DD, on or after start, at most a year later.

Response

OK

lines_movedinteger required

How many creators' post dates moved.

Changes

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