---
search:
  tags:
    - organization-commands
    - POST
seo:
  description: >-
    Create or update a private lesson type with its pricing,… Reference for the
    POST /commands/save_private_lesson_type endpoint in the Soljio Organization
    API.
sidebar:
  label: >-
    Create or update a private lesson type with its pricing, rules, locations
    and instructors.
  badge: POST
title: >-
  Create or update a private lesson type with its pricing, rules, locations and
  instructors.
type: openapi-operation
---
Create or update a private lesson type with its pricing, rules, locations and instructors. Requires private_lessons.write. All writes require Idempotency-Key; x-scope-rules declares additional grants by input condition.

`POST /commands/save_private_lesson_type`

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

- `id` (string) — Opaque Soljio resource ID.
- `allow_instructor_choice` (boolean, required)
- `allow_pay_later` (boolean, required)
- `approval_hours` (number, required)
- `booking_increment_minutes` (number, required)
- `buffer_after_minutes` (number, required)
- `buffer_before_minutes` (number, required)
- `cancellation_hours` (number, required)
- `capacity` (number, required)
- `description` (string, required)
- `duration_minutes` (number, required)
- `horizon_days` (number, required)
- `instructor_permissions` (object, required)
- `invitation_hours` (number, required)
- `locations` (object[], required)
- `max_age` (number)
- `min_age` (number)
- `name` (string, required)
- `notice_hours` (number, required)
- `payment_hours` (number, required)
- `pricing` (object, required)
- `published` (boolean, required)
- `reminder_hours` (number, required)
- `requires_approval` (boolean, required)
- `skill_levels` (string[], required)

Request body example:

```json
{
  "id": "string",
  "allow_instructor_choice": true,
  "allow_pay_later": true,
  "approval_hours": 0,
  "booking_increment_minutes": 0,
  "buffer_after_minutes": 0,
  "buffer_before_minutes": 0,
  "cancellation_hours": 0,
  "capacity": 0,
  "description": "string",
  "duration_minutes": 0,
  "horizon_days": 0,
  "instructor_permissions": {
    "approval": true,
    "availability": true,
    "reschedule": true
  },
  "invitation_hours": 0,
  "locations": [
    {
      "instructor_ids": [
        "string"
      ],
      "location_id": "string",
      "resource_groups": [
        [
          "string"
        ]
      ]
    }
  ],
  "max_age": 0,
  "min_age": 0,
  "name": "string",
  "notice_hours": 0,
  "payment_hours": 0,
  "pricing": {
    "amount_minor": 0,
    "currency": "string",
    "group_rates": [
      {
        "amount_minor": 0,
        "students": 0
      }
    ],
    "mode": "booking"
  },
  "published": true,
  "reminder_hours": 0,
  "requires_approval": true,
  "skill_levels": [
    "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": "string",
  "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"
}
```
