# Update a publication

> Reschedule a scheduled publication or draft, or replace its post.

Canonical: <https://www.tryadeli.com/docs/api/posts/update-publication>

`PATCH https://app.tryadeli.com/api/v1/publications/{publicationId}`

Authorization: `Bearer <API key>` — see [Authentication](https://www.tryadeli.com/docs/authentication)

Reschedules a scheduled publication or a draft, or replaces its post. A draft
given a `scheduledFor` becomes scheduled. Only a publication that is still
`scheduled` or a `draft` can change: once it has started, or was canceled, the
request answers `409`.

**Path parameters**

| Name            | Type   | Required | Description                                           |
| --------------- | ------ | -------- | ----------------------------------------------------- |
| `publicationId` | `uuid` | Yes      | The id from the create response or List publications. |

**Body**

| Name           | Type     | Required | Description                                                                                                          |
| -------------- | -------- | -------- | -------------------------------------------------------------------------------------------------------------------- |
| `scheduledFor` | `string` |          | The new time, as ISO 8601 with a UTC offset, from one minute to 365 days ahead.                                      |
| `timeZone`     | `string` |          | The IANA zone the time was chosen in, such as America/New\_York. Kept only for display.                              |
| `platforms`    | `array`  |          | Replaces the whole post, with the same shape as Publish to several accounts. Required when content or media is sent. |
| `content`      | `string` |          | The new shared text, with platforms.                                                                                 |
| `media`        | `array`  |          | The new shared media, with platforms.                                                                                |

A replaced post is validated exactly as [Publish to several
accounts](https://www.tryadeli.com/docs/api/posts/create-publication) validates a new one.

## Request examples

**cURL**

```bash
curl -X PATCH "https://app.tryadeli.com/api/v1/publications/00000000-0000-4000-8000-000000000020" \
  -H "Authorization: Bearer $ADELI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "scheduledFor": "2026-11-14T08:00:00-05:00",
  "timeZone": "America/New_York"
}'
```

**JavaScript**

```javascript
const response = await fetch("https://app.tryadeli.com/api/v1/publications/00000000-0000-4000-8000-000000000020", {
  method: "PATCH",
  headers: {
    Authorization: `Bearer ${process.env.ADELI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    scheduledFor: "2026-11-14T08:00:00-05:00",
    timeZone: "America/New_York",
  }),
});
console.log(await response.json());
```

**Python**

```python
import os

import requests

response = requests.patch(
    "https://app.tryadeli.com/api/v1/publications/00000000-0000-4000-8000-000000000020",
    headers={"Authorization": f"Bearer {os.environ['ADELI_API_KEY']}"},
    json={
        "scheduledFor": "2026-11-14T08:00:00-05:00",
        "timeZone": "America/New_York",
    },
)
print(response.json())
```

## Responses

### 200

```json
{
  "id": "00000000-0000-4000-8000-000000000020",
  "profileId": "00000000-0000-4000-8000-000000000001",
  "status": "scheduled",
  "progress": 0,
  "scheduledFor": "2026-11-14T13:00:00.000Z",
  "timeZone": "America/New_York",
  "canceledAt": null,
  "statusUrl": "/api/v1/publications/00000000-0000-4000-8000-000000000020",
  "createdAt": "2026-11-10T15:00:00.000Z",
  "updatedAt": "2026-11-10T15:05:00.000Z",
  "completedAt": null,
  "targets": [
    { "id": "00000000-0000-4000-8000-000000000021", "platform": "instagram", "accountId": "00000000-0000-0000-0000-000000000010", "status": "queued", "attempts": 0, "result": null, "error": null }
  ]
}
```

### 409

```json
{
  "error": {
    "code": "publication_in_progress",
    "message": "The publication has already started, so it can no longer be changed"
  }
}
```
