Read a studio
One studio of the organization with the state of its hand-over. An unknown, foreign or archived id is
404 BUSINESS_NOT_FOUND. Org-level: send no Shyni-Business header. Requires the businesses:read scope.
ApiKeyAuth businesses:readAuthorizationBearer <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: businesses:read
id*stringThe studio.
application/json- response
id*stringSend it as Shyni-Business to act on this studio.
name*stringslug*stringcreatedAt*stringdate-timehandedOver*booleantrue once the owner took the studio over (or the organization only has access to it); the studio's own plan applies from then on.
ownerInvite*|The pending owner invitation; null before the first invitation and after the hand-over.
curl -X GET 'https://api.shyni.io/api/v1/studios/string' \ -H 'Authorization: Bearer shyni_sk_test_YOUR_KEY'Response 200
The studio.
{ "id": "string", "name": "string", "slug": "string", "createdAt": "2019-08-24T14:15:22Z", "handedOver": true, "ownerInvite": { "email": "string", "sentAt": "2019-08-24T14:15:22Z" }}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 business does not exist, belongs to another organization, was archived or has another mode than the key (BUSINESS_NOT_FOUND) - one answer for all of them.
{ "code": "BUSINESS_NOT_FOUND", "message": "Business not found."}Response 429
Burst rate limit exceeded.
{ "code": "RATE_LIMITED", "message": "Too many requests. Retry after the time given in the Retry-After header."}