ShyniAPI
Availability

Set the opening hours of several weekdays

PUT
/api/v1/availability/hours

Replaces the intervals of every listed weekday in one step; a weekday you do not list stays as it is, an empty intervals closes the day. One invalid day changes nothing. A day holds at most 4 intervals, each openTime before its closeTime, none overlapping or touching. The hours are written to the studio's draft, exactly as the admin does, and go live with the studio's next publish. The answer is the whole week as the draft now holds it. Requires the availability:write scope and an Idempotency-Key header; no particular plan.

Authorization

ApiKeyAuth availability:write
headerAuthorizationBearer <shyni_sk_live_*>

An API key, issued once and never retrievable again: an organization key in the developer portal, or a studio key in the studio's admin (Moje studio → API). Send as Authorization: Bearer shyni_sk_live_....

Scope: availability:write

Header Parameters

Idempotency-Key*string

Caller-chosen idempotency token for this write. A retry under the SAME key with the SAME body replays the first response; the SAME key with a DIFFERENT body is 422 IDEMPOTENCY_KEY_MISMATCH. See Idempotency above.

Lengthlength <= 64

Request Body

application/json
  1. body
days*array<>

Response Body

The week.

application/json
  1. response
days*array<>

Seven entries, Monday first.

Example Request
curl -X PUT 'https://api.shyni.io/api/v1/availability/hours' \  -H 'Authorization: Bearer shyni_sk_test_YOUR_KEY' \  -H 'Idempotency-Key: 7f3c9a52-1d4e-4b86-a0c7-5e2b9d8f6a13' \  -H 'Content-Type: application/json' \  -d '{  "days": [    {      "weekday": "MONDAY"    }  ]}'

Response 200

The week.

{  "days": [    {      "weekday": "MONDAY",      "intervals": [        {          "openTime": "string",          "closeTime": "string"        }      ]    }  ]}

Response 400

A parameter, header or request body is missing, malformed, or out of range. A request body property the endpoint does not define answers UNKNOWN_FIELD instead, with field naming it.

{  "code": "INVALID_INPUT",  "message": "Parameter perPage must be between 1 and 100."}

Response 401

Missing, malformed, unknown, or revoked API key (INVALID_API_KEY).

{  "code": "INVALID_API_KEY",  "message": "Missing or invalid API key."}

Response 403

The key is valid but the request is refused. Branch on code: INSUFFICIENT_SCOPE (the key lacks the permission this endpoint requires), PLAN_REQUIRED (the studio is not on a plan that includes API keys, Pro and above), ORIGIN_NOT_ALLOWED, SECRET_KEY_IN_BROWSER, or DEMO_STUDIO on a write to the demo studio. See Authentication and Scopes above.

{  "code": "INSUFFICIENT_SCOPE",  "message": "This API key does not have the permission this endpoint requires."}

Response 409

The request is well-formed but the studio's current state forbids it.

{  "code": "CONFLICT",  "message": "The voucher cannot be deactivated because it is not active."}

Response 422

The same Idempotency-Key was already used for a request with a different body, use a new key (see Idempotency above).

{  "code": "IDEMPOTENCY_KEY_MISMATCH",  "message": "This Idempotency-Key was already used for a different request. Use a new key."}

Response 429

Burst rate limit exceeded.

{  "code": "RATE_LIMITED",  "message": "Too many requests. Retry after the time given in the Retry-After header."}

Get the opening hours GET

Previous Page

Set the opening hours of one weekday PUT

Next Page