---
search:
  tags:
    - organization-commands
    - POST
seo:
  description: >-
    Validate the entire command without committing… Reference for the POST
    /commands/preview_replace_offering_schedule endpoint in the Soljio
    Organization API.
sidebar:
  label: >-
    Preview: Replace the future schedule with reviewed dates and recurring
    rules.
  badge: POST
title: 'Preview: Replace the future schedule with reviewed dates and recurring rules.'
type: openapi-operation
---
Validate the entire command without committing its domain effects. Returns reviewed input and change counts; approval expires in 15 minutes. Requires schedule.preview and non-apply scopes of the target command.

`POST /commands/preview_replace_offering_schedule`

**Request body** (`application/json`, required)

- `allow_protected_changes` (boolean)
- `offering_id` (string, required) — Opaque Soljio resource ID.
- `recurring_schedule_rules` (object[])
- `regenerate_rules` (boolean)
- `schedule_sessions` (object[], required)
- `timezone` (string, required)

Request body example:

```json
{
  "allow_protected_changes": true,
  "offering_id": "string",
  "recurring_schedule_rules": [
    {
      "days_of_week": [
        "monday"
      ],
      "duration_minutes": 0,
      "end_date": "string",
      "interval_weeks": 0,
      "local_start_time": "string",
      "start_date": "string"
    }
  ],
  "regenerate_rules": true,
  "schedule_sessions": [
    {
      "ends_at": "2019-08-24T14:15:22Z",
      "local_date": "string",
      "local_end_time": "string",
      "local_start_time": "string",
      "session_id": "string",
      "source": "custom",
      "starts_at": "2019-08-24T14:15:22Z",
      "timezone": "string"
    }
  ],
  "timezone": "string"
}
```

**Responses**

- `200` — Successful command; replay returns the original result.
- `400` — invalid\_request
- `401` — unauthorized
- `403` — forbidden
- `404` — not\_found
- `405` — method\_not\_allowed
- `409` — conflict, idempotency\_conflict
- `413` — payload\_too\_large
- `415` — unsupported\_media\_type
- `429` — rate\_limited
- `500` — internal\_error

Response example, 200:

```json
{
  "data": {
    "approval_token": "string",
    "changes": {
      "created": 0,
      "deleted": 0,
      "updated": 0
    },
    "expires_at": "2019-08-24T14:15:22Z",
    "organization_id": "string",
    "preview_id": "string",
    "proposed_input": {
      "allow_protected_changes": true,
      "offering_id": "string",
      "recurring_schedule_rules": [
        {
          "days_of_week": [
            "monday"
          ],
          "duration_minutes": 0,
          "end_date": "string",
          "interval_weeks": 0,
          "local_start_time": "string",
          "start_date": "string"
        }
      ],
      "regenerate_rules": true,
      "schedule_sessions": [
        {
          "ends_at": "2019-08-24T14:15:22Z",
          "local_date": "string",
          "local_end_time": "string",
          "local_start_time": "string",
          "session_id": "string",
          "source": "custom",
          "starts_at": "2019-08-24T14:15:22Z",
          "timezone": "string"
        }
      ],
      "timezone": "string"
    },
    "requires_approval": true
  },
  "idempotent_replay": true,
  "request_id": "266ea41d-adf5-480b-af50-15b940c2b846"
}
```

Response example, 400:

```json
{
  "error": {
    "code": "invalid_request",
    "message": "The request is invalid."
  },
  "request_id": "00000000-0000-4000-8000-000000000001"
}
```

Response example, 401:

```json
{
  "error": {
    "code": "unauthorized",
    "message": "A valid service token is required."
  },
  "request_id": "00000000-0000-4000-8000-000000000001"
}
```

Response example, 403:

```json
{
  "error": {
    "code": "forbidden",
    "message": "The service token lacks a required scope."
  },
  "request_id": "00000000-0000-4000-8000-000000000001"
}
```

Response example, 404:

```json
{
  "error": {
    "code": "not_found",
    "message": "The requested resource was not found."
  },
  "request_id": "00000000-0000-4000-8000-000000000001"
}
```

Response example, 405:

```json
{
  "error": {
    "code": "method_not_allowed",
    "message": "The method is not supported for this resource."
  },
  "request_id": "00000000-0000-4000-8000-000000000001"
}
```

Response example, 409:

```json
{
  "error": {
    "code": "conflict",
    "message": "The command conflicts with the current state."
  },
  "request_id": "00000000-0000-4000-8000-000000000001"
}
```

Response example, 413:

```json
{
  "error": {
    "code": "payload_too_large",
    "message": "The request body exceeds the byte limit for this operation."
  },
  "request_id": "00000000-0000-4000-8000-000000000001"
}
```

Response example, 415:

```json
{
  "error": {
    "code": "unsupported_media_type",
    "message": "Use application/json for command requests."
  },
  "request_id": "00000000-0000-4000-8000-000000000001"
}
```

Response example, 429:

```json
{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests. Retry after the indicated delay."
  },
  "request_id": "00000000-0000-4000-8000-000000000001"
}
```

Response example, 500:

```json
{
  "error": {
    "code": "internal_error",
    "message": "The request could not be completed."
  },
  "request_id": "00000000-0000-4000-8000-000000000001"
}
```
