ShyniAPI
Catalog

Change a question of a service group

PATCH
/api/v1/service-questions/{id}

Changes a question; an omitted field stays, an empty unansweredName or unansweredSentence clears it. options, when given, replaces the list: an option carrying its id is kept and changed, one without is new, one left out is removed (and stripped from the entries that preselected it). Draft. Audited with the API key as the actor. PRO plan and above, as on the admin. Requires the catalog:write scope and an Idempotency-Key header.

Authorization

ApiKeyAuth catalog: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: catalog:write

Path Parameters

id*string

The question id.

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

Every field optional; options, when given, replaces the list.

name?string
Lengthlength <= 255
sortOrder?integer
Range0 <= value
unansweredName?string
unansweredSentence?string
options?array<>

Response Body

The changed question.

application/json
  1. response

A configurator question of a group.

id*string
groupId*string
name*string
sortOrder*integer
unansweredName*string|null
unansweredSentence*string|null
options*array<>
stageLinks*array<>
Example Request
curl -X PATCH 'https://api.shyni.io/api/v1/service-questions/string' \  -H 'Authorization: Bearer shyni_sk_test_YOUR_KEY' \  -H 'Idempotency-Key: 7f3c9a52-1d4e-4b86-a0c7-5e2b9d8f6a13' \  -H 'Content-Type: application/json' \  -d '{}'

Response 200

The changed question.

{  "id": "string",  "groupId": "string",  "name": "string",  "sortOrder": 0,  "unansweredName": "string",  "unansweredSentence": "string",  "options": [    {      "id": "string",      "name": "string",      "sentence": "string",      "surcharge": 0,      "scalesWithSize": true,      "extraMinutes": 0,      "isDefault": true    }  ],  "stageLinks": [    {      "serviceId": "string",      "required": true,      "requiredSentence": "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 404

The resource does not exist, or belongs to a different studio.

{  "code": "NOT_FOUND",  "message": "Order not found."}

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."}

Create a question of a service group POST

Previous Page

Delete a question of a service group DELETE

Next Page