---
title: "Reschedule Post"
method: POST
path: "/v1/queue/{scheduleId}/reschedule"
tags: ["Queue"]
---

# Reschedule Post

`POST /v1/queue/{scheduleId}/reschedule`

## Request

- Base URL: `https://api.linkedmash.com`
- URL: `https://api.linkedmash.com/v1/queue/{scheduleId}/reschedule`
- Auth: one of:
  - OAuth 2 (client credentials, token URL `https://api.linkedmash.com/auth/oauth/token`, scopes: `content:write`)
  - HTTP bearer
  - API key in header `linkedmash-api-key`

Move a scheduled post to a new time or the next open slot. Requires a paid Premium or Lifetime plan.

POST /v1/queue/{scheduleId}/reschedule moves an already-scheduled post to a different time without cancelling and re-creating it. publish_at takes an ISO-8601 timestamp or the literal 'next-slot', and timezone is a required IANA zone in both cases.

Unlike the schedule route, timezone is mandatory here even for 'next-slot', because slot resolution is done in the user's local grid and there is no 'now' shortcut to fall back on.

## Path parameters

- `scheduleId` string, required

## Request body

- object
  - `publish_at` union: An ISO-8601 timestamp or 'next-slot'.
    - 'next-slot'
    - string: ISO-8601 local or offset timestamp, interpreted with the timezone field.
  - `timezone` string: IANA timezone for the new time.

## Response `200`

Successful response.

- object
  - `status` boolean, required
  - `data` object, required
    - `ok` boolean, required
    - `newRunAtUTC` string, date-time, required

## Other responses

- `400`: Bad Request. publish_at or timezone missing, or 'next-slot' with no free slot in the schedule.
- `401`: Unauthorized. The Authorization header is missing or the key is not a valid LinkedMash API key. Create or rotate keys on the API page in your LinkedMash settings.
- `402`: Payment Required. Returned with code SUBSCRIPTION_REQUIRED. The content API requires a Premium or Lifetime plan; Reader and free accounts get this on every /v1/posts, /v1/queue, /v1/schedule, /v1/media and /v1/analytics call.
- `404`: Not Found. No queue entry with that scheduleId on this account.
- `500`: Server Error. Something failed on our side. The body carries message "Failed to reschedule the post". Retry once; if it persists the request is not the problem.

---

[API](https://skmtc.dev/linkedmash/apis/linkedmash-api.md) · [All operations](https://skmtc.dev/linkedmash/apis/linkedmash-api/llms.txt) · [OpenAPI document](https://skmtc.dev/linkedmash/apis/linkedmash-api/revisions/eef45d6fbea3?raw)