Skip to content
Soljio Docs
Esc
↑↓navigate↵open⌘Jpreview

Create or update a private lesson type with its pricing, rules, locations and instructors.

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
Authorization
AuthorizationBearer token (soljio_sk_<secret>) · headerrequired

Organization-scoped service token created by an owner/admin. Scope requirements are in x-required-scopes; these are service-token grants, not OAuth scopes. Revoked, expired, unknown and suspended-organization credentials all return 401.

Header parameters
Idempotency-Keystringrequired

Persist with the job and reuse for retries. Scoped to organization, token, command and API version. Different input with the same key returns 409. Supported automatic retry window: 24 hours.

min length 1 · max length 128 · matches ^[!-~]+$
Request body
requiredapplication/json
idstring

Opaque Soljio resource ID.

min length 1
allow_instructor_choicebooleanrequired
allow_pay_laterbooleanrequired
approval_hoursnumberrequired
booking_increment_minutesnumberrequired
buffer_after_minutesnumberrequired
buffer_before_minutesnumberrequired
cancellation_hoursnumberrequired
capacitynumberrequired
descriptionstringrequired
duration_minutesnumberrequired
horizon_daysnumberrequired
instructor_permissionsobjectrequired
Show properties
approvalbooleanrequired
availabilitybooleanrequired
reschedulebooleanrequired
invitation_hoursnumberrequired
locationsobject[]required
Show properties
Array of object
instructor_idsstring[]required
location_idstringrequired

Opaque Soljio resource ID.

min length 1
resource_groupsstring[][]required
max_agenumber
min_agenumber
namestringrequired
notice_hoursnumberrequired
payment_hoursnumberrequired
pricingobjectrequired
Show properties
amount_minornumberrequired
currencystringrequired
group_ratesobject[]required
Show properties
Array of object
amount_minornumberrequired
studentsnumberrequired
modestringrequired
Show properties
Any of:
string
string
string
string
publishedbooleanrequired
reminder_hoursnumberrequired
requires_approvalbooleanrequired
skill_levelsstring[]required
Responses
200

Successful command; replay returns the original result.

datastringrequired

Opaque Soljio resource ID.

min length 1
idempotent_replaybooleanrequired
request_idstring<uuid>required
400

invalid_request

errorobjectrequired
Show properties
codestringrequired
Allowed:invalid_request
messagestringrequired
request_idstring<uuid>required
401

unauthorized

errorobjectrequired
Show properties
codestringrequired
Allowed:unauthorized
messagestringrequired
request_idstring<uuid>required
403

forbidden

errorobjectrequired
Show properties
codestringrequired
Allowed:forbidden
messagestringrequired
request_idstring<uuid>required
404

not_found

errorobjectrequired
Show properties
codestringrequired
Allowed:not_found
messagestringrequired
request_idstring<uuid>required
405

method_not_allowed

errorobjectrequired
Show properties
codestringrequired
Allowed:method_not_allowed
messagestringrequired
request_idstring<uuid>required
409

conflict, idempotency_conflict

errorobjectrequired
Show properties
codestringrequired
Allowed:conflictidempotency_conflict
messagestringrequired
request_idstring<uuid>required
413

payload_too_large

errorobjectrequired
Show properties
codestringrequired
Allowed:payload_too_large
messagestringrequired
request_idstring<uuid>required
415

unsupported_media_type

errorobjectrequired
Show properties
codestringrequired
Allowed:unsupported_media_type
messagestringrequired
request_idstring<uuid>required
429

rate_limited

errorobjectrequired
Show properties
codestringrequired
Allowed:rate_limited
messagestringrequired
request_idstring<uuid>required
500

internal_error

errorobjectrequired
Show properties
codestringrequired
Allowed:internal_error
messagestringrequired
request_idstring<uuid>required
Try it
Server
Authorization
Parameters
Bodyapplication/json
Request
curl -X POST 'https://api.soljio.com/v0/commands/save_private_lesson_type' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Idempotency-Key: string' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "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"
  ]
}'
Response
{
  "data": "string",
  "idempotent_replay": true,
  "request_id": "266ea41d-adf5-480b-af50-15b940c2b846"
}