{"openapi":"3.1.0","info":{"title":"Studio Network API","version":"1.0.0","description":"Public discovery and transaction gateway for opted-in Studio OS businesses. Sending a request creates a real sales inquiry. Accepting a quote records buyer acceptance but still requires the provider's own confirmation."},"servers":[{"url":"https://network.hiiustudio.ee"}],"paths":{"/v1/studios":{"get":{"operationId":"listStudios","summary":"List opted-in businesses and services","responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/studios/{studioSlug}":{"get":{"operationId":"getStudio","summary":"Get one live business profile","parameters":[{"name":"studioSlug","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9][a-z0-9_-]*$","maxLength":80}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Not found"}}}},"/v1/studios/{studioSlug}/requests":{"post":{"operationId":"requestService","summary":"Request a quote or availability","description":"Consequential write: submit only after the buyer confirms.","parameters":[{"name":"studioSlug","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9][a-z0-9_-]*$","maxLength":80}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["intent","buyer","message"],"properties":{"intent":{"type":"string","enum":["quote","availability","quote_and_availability"]},"buyer":{"type":"object","additionalProperties":false,"required":["name","email"],"properties":{"name":{"type":"string","maxLength":200},"email":{"type":"string","format":"email"},"company":{"type":"string","maxLength":240},"phone":{"type":"string","maxLength":80},"language":{"type":"string","maxLength":8}}},"serviceKey":{"type":"string","maxLength":80},"serviceName":{"type":"string","maxLength":200},"message":{"type":"string","minLength":1,"maxLength":4000},"quantity":{"type":"number","exclusiveMinimum":0},"requestedStart":{"type":"string","format":"date"},"requestedEnd":{"type":"string","format":"date"},"buyerStudioSlug":{"type":"string","maxLength":80},"idempotencyKey":{"type":"string","minLength":8,"maxLength":200}},"anyOf":[{"required":["serviceKey"]},{"required":["serviceName"]}]}}}},"responses":{"202":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request"},"404":{"description":"Studio unavailable"},"429":{"description":"Rate limit exceeded"}}}},"/v1/studios/{studioSlug}/requests/{statusToken}":{"get":{"operationId":"checkRequest","summary":"Check request, availability, quote, or delivery status","parameters":[{"name":"studioSlug","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9][a-z0-9_-]*$","maxLength":80}},{"name":"statusToken","in":"path","required":true,"schema":{"type":"string","minLength":20,"maxLength":2000}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Not found"}}}},"/v1/studios/{studioSlug}/requests/{statusToken}/accept":{"post":{"operationId":"acceptQuote","summary":"Record explicit buyer acceptance of an exact quote revision","description":"Consequential write. This raises the provider's confirmation workflow; it does not silently close the deal.","parameters":[{"name":"studioSlug","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9][a-z0-9_-]*$","maxLength":80}},{"name":"statusToken","in":"path","required":true,"schema":{"type":"string","minLength":20,"maxLength":2000}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["quoteId","quoteRevision"],"properties":{"quoteId":{"type":"string","maxLength":64},"quoteRevision":{"type":"string","maxLength":64},"idempotencyKey":{"type":"string","minLength":8,"maxLength":200}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Rejected"}}}}},"externalDocs":{"description":"Studio Network discovery","url":"https://network.hiiustudio.ee/"}}