{"openapi":"3.1.1","info":{"title":"Retro Reusch Tattoo API","version":"1.0.0","description":"Artist APIs require platform sign-in. Enquiry creation accepts a signed guest browser session. CSRF alone does not authorize writes. No autonomous service-user credentials are issued."},"servers":[{"url":"https://retroreuschtattoo.com"}],"externalDocs":{"url":"https://retroreuschtattoo.com/agents.md","description":"Authentication and integration guide"},"paths":{"/api/v1/catalog":{"get":{"operationId":"getCatalog","summary":"Read published portfolio, FAQ and booking capabilities","responses":{"200":{"description":"Public-content catalog, still subject to the Site hosting audience.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/session":{"get":{"operationId":"getBrowserSession","summary":"Read current browser access and obtain a CSRF token","x-browser-session-required":true,"responses":{"200":{"description":"Browser access; this is not a service-account login.","content":{"application/json":{"schema":{"type":"object"}}}},"503":{"description":"Request rejected; JSON contains an error message."}}}},"/api/bookings":{"post":{"security":[{"csrfToken":[]}],"x-browser-session-required":true,"operationId":"submitBookingRequest","summary":"Save a user-approved enquiry; does not book an appointment","requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","required":["clientRequestId","details","contactWebsite"],"properties":{"clientRequestId":{"type":"string","format":"uuid"},"details":{"type":"string","description":"JSON-serialized BookingDetails"},"images":{"type":"array","maxItems":4,"items":{"type":"string","format":"binary"}},"contactWebsite":{"type":"string","maxLength":0,"description":"Spam-trap field; must be empty."}}},"encoding":{"details":{"contentType":"text/plain"},"images":{"contentType":"image/jpeg, image/png, image/webp"}}}}},"responses":{"200":{"description":"Same request already saved.","content":{"application/json":{"schema":{"type":"object"}}}},"201":{"description":"Request saved.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Request rejected; JSON contains an error message."},"401":{"description":"Request rejected; JSON contains an error message."},"403":{"description":"Request rejected; JSON contains an error message."},"409":{"description":"Request rejected; JSON contains an error message."},"413":{"description":"Request rejected; JSON contains an error message."},"415":{"description":"Request rejected; JSON contains an error message."},"429":{"description":"Request rejected; JSON contains an error message."},"503":{"description":"Request rejected; JSON contains an error message."}},"x-guest-submissions":true}},"/api/artist/requests":{"get":{"operationId":"listArtistRequests","summary":"Artist-only request search","x-artist-only":true,"x-browser-session-required":true,"parameters":[{"name":"status","in":"query","schema":{"type":"string","enum":["new","reviewing","awaiting_client","approved","scheduled","completed","declined"]}},{"name":"search","in":"query","schema":{"type":"string","maxLength":100}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"maximum":100000}},{"name":"style","in":"query","schema":{"type":"string"}},{"name":"placement","in":"query","schema":{"type":"string","maxLength":100}},{"name":"from","in":"query","schema":{"type":"string","format":"date"},"description":"Inclusive UTC submission date"},{"name":"to","in":"query","schema":{"type":"string","format":"date"},"description":"Inclusive UTC submission date"},{"name":"sort","in":"query","schema":{"type":"string","enum":["newest","oldest","updated"]}},{"name":"archived","in":"query","schema":{"type":"string","enum":["true","false"]}}],"responses":{"200":{"description":"Private request list, up to 50 per page.","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Request rejected; JSON contains an error message."},"403":{"description":"Request rejected; JSON contains an error message."}}}},"/api/artist/requests/{id}":{"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"get":{"operationId":"getArtistRequest","x-artist-only":true,"x-browser-session-required":true,"responses":{"200":{"description":"Private request details.","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Request rejected; JSON contains an error message."},"403":{"description":"Request rejected; JSON contains an error message."},"404":{"description":"Request rejected; JSON contains an error message."}}},"patch":{"security":[{"csrfToken":[]}],"x-browser-session-required":true,"operationId":"updateArtistRequest","x-artist-only":true,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["status","notes","version"],"properties":{"status":{"type":"string","enum":["new","reviewing","awaiting_client","approved","scheduled","completed","declined"]},"notes":{"type":"string","maxLength":10000},"version":{"type":"integer","minimum":1},"confirmDecline":{"type":"boolean","description":"Explicit confirmation required when changing to declined."}}}}}},"responses":{"200":{"description":"Updated request.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Request rejected; JSON contains an error message."},"401":{"description":"Request rejected; JSON contains an error message."},"403":{"description":"Request rejected; JSON contains an error message."},"409":{"description":"Request rejected; JSON contains an error message."}}},"delete":{"security":[{"csrfToken":[]}],"x-browser-session-required":true,"x-artist-only":true,"operationId":"archiveTattooRequest","summary":"Move a confirmed request to the recoverable archive; retain photos and notes","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["version","confirmDelete"],"properties":{"version":{"type":"integer","minimum":1},"confirmDelete":{"const":true}}}}}},"responses":{"200":{"description":"Request archived without permanent deletion.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Request rejected; JSON contains an error message."},"401":{"description":"Request rejected; JSON contains an error message."},"403":{"description":"Request rejected; JSON contains an error message."},"404":{"description":"Request rejected; JSON contains an error message."},"409":{"description":"Request rejected; JSON contains an error message."}}}},"/api/artist/attachments/{id}":{"get":{"operationId":"getArtistReferenceImage","x-artist-only":true,"x-browser-session-required":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Artist-only JPEG/PNG/WebP image.","content":{"image/jpeg":{"schema":{"type":"string","format":"binary"}},"image/png":{"schema":{"type":"string","format":"binary"}},"image/webp":{"schema":{"type":"string","format":"binary"}}}},"401":{"description":"Request rejected; JSON contains an error message."},"403":{"description":"Request rejected; JSON contains an error message."},"404":{"description":"Request rejected; JSON contains an error message."}}}},"/api/artist/notifications":{"get":{"operationId":"getNotificationStatus","x-artist-only":true,"x-browser-session-required":true,"summary":"Read configuration readiness and outbox counts; accepted does not mean delivered","responses":{"200":{"description":"Private notification status.","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Request rejected; JSON contains an error message."},"403":{"description":"Request rejected; JSON contains an error message."}}}},"/api/artist/notifications/retry":{"post":{"security":[{"csrfToken":[]}],"x-browser-session-required":true,"operationId":"retryPendingNotifications","x-artist-only":true,"summary":"Artist-approved retry of up to three due notifications, preserving provider idempotency","responses":{"200":{"description":"Private notification status after retry.","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Request rejected; JSON contains an error message."},"403":{"description":"Request rejected; JSON contains an error message."}}}},"/api/artist/requests/{id}/restore":{"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"post":{"security":[{"csrfToken":[]}],"x-browser-session-required":true,"x-artist-only":true,"operationId":"restoreTattooRequest","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["version"],"properties":{"version":{"type":"integer","minimum":1}}}}}},"responses":{"200":{"description":"Request restored.","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Request rejected; JSON contains an error message."},"403":{"description":"Request rejected; JSON contains an error message."},"404":{"description":"Request rejected; JSON contains an error message."},"409":{"description":"Request rejected; JSON contains an error message."}}}},"/api/artist/consultations":{"get":{"operationId":"listPrivateConsultations","x-artist-only":true,"x-browser-session-required":true,"responses":{"200":{"description":"Private consultation overview and availability settings.","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Request rejected; JSON contains an error message."},"403":{"description":"Request rejected; JSON contains an error message."}}}},"/api/artist/consultations/settings":{"put":{"security":[{"csrfToken":[]}],"x-browser-session-required":true,"x-artist-only":true,"operationId":"updateConsultationAvailability","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["settings","version"],"properties":{"settings":{"type":"object"},"version":{"type":"integer","minimum":1}}}}}},"responses":{"200":{"description":"Versioned availability saved; existing reservations retained.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Request rejected; JSON contains an error message."},"401":{"description":"Request rejected; JSON contains an error message."},"403":{"description":"Request rejected; JSON contains an error message."},"409":{"description":"Request rejected; JSON contains an error message."}}}},"/api/artist/requests/{id}/consultation":{"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"get":{"operationId":"getRequestConsultation","x-artist-only":true,"x-browser-session-required":true,"responses":{"200":{"description":"Consultation status and private history; no link credentials.","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Request rejected; JSON contains an error message."},"403":{"description":"Request rejected; JSON contains an error message."},"404":{"description":"Request rejected; JSON contains an error message."}}},"post":{"security":[{"csrfToken":[]}],"x-browser-session-required":true,"x-artist-only":true,"operationId":"manageRequestConsultation","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["action","version","confirmed"],"properties":{"action":{"enum":["invite","revoke","cancel","completed","no_show"]},"version":{"type":"integer","minimum":0},"confirmed":{"const":true}}}}}},"responses":{"200":{"description":"Artist-approved consultation action saved.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Request rejected; JSON contains an error message."},"401":{"description":"Request rejected; JSON contains an error message."},"403":{"description":"Request rejected; JSON contains an error message."},"404":{"description":"Request rejected; JSON contains an error message."},"409":{"description":"Request rejected; JSON contains an error message."},"503":{"description":"Request rejected; JSON contains an error message."}}}},"/api/consultations":{"post":{"security":[{"csrfToken":[]}],"x-browser-session-required":true,"operationId":"useInvitedConsultation","x-invitation-capability-required":true,"description":"Only an artist-issued expiring capability plus browser session and same-origin CSRF permit consultation access or mutation. No inquiry details are returned. Explicit human authorization is required for booking, cancellation or rescheduling.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["token","action"],"properties":{"token":{"type":"string","format":"password","writeOnly":true,"minLength":43,"maxLength":43},"action":{"enum":["access","slots","book","cancel"]},"day":{"type":"string","format":"date"},"startAt":{"type":"integer"},"version":{"type":"integer","minimum":1},"settingsVersion":{"type":"integer","minimum":1},"actionId":{"type":"string","format":"uuid"},"acknowledged":{"type":"boolean"}}}}}},"responses":{"200":{"description":"Own consultation or available times; never private inquiry data.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Request rejected; JSON contains an error message."},"401":{"description":"Request rejected; JSON contains an error message."},"403":{"description":"Request rejected; JSON contains an error message."},"409":{"description":"Request rejected; JSON contains an error message."},"429":{"description":"Request rejected; JSON contains an error message."},"503":{"description":"Request rejected; JSON contains an error message."}}}},"/api/website-requests":{"post":{"security":[{"csrfToken":[]}],"x-browser-session-required":true,"operationId":"submitArtistWebsiteRequest","summary":"Save a user-approved website enquiry in the private artist inbox","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["clientRequestId","name","email","contactWebsite"],"properties":{"clientRequestId":{"type":"string","format":"uuid"},"name":{"type":"string","maxLength":100},"email":{"type":"string","maxLength":254,"format":"email"},"phone":{"type":"string","maxLength":40},"instagram":{"type":"string","maxLength":150},"studio":{"type":"string","maxLength":150},"message":{"type":"string","maxLength":1500},"contactWebsite":{"type":"string","maxLength":0,"description":"Spam-trap field; must be empty."}}}}}},"responses":{"200":{"description":"Same request already saved.","content":{"application/json":{"schema":{"type":"object"}}}},"201":{"description":"Website request saved.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Request rejected; JSON contains an error message."},"401":{"description":"Request rejected; JSON contains an error message."},"403":{"description":"Request rejected; JSON contains an error message."},"409":{"description":"Request rejected; JSON contains an error message."},"413":{"description":"Request rejected; JSON contains an error message."},"415":{"description":"Request rejected; JSON contains an error message."},"429":{"description":"Request rejected; JSON contains an error message."},"503":{"description":"Request rejected; JSON contains an error message."}},"x-guest-submissions":true}},"/api/artist/website-requests":{"get":{"operationId":"listWebsiteRequests","x-artist-only":true,"x-browser-session-required":true,"parameters":[{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"maximum":100000}}],"responses":{"200":{"description":"Private website enquiries, up to 50 per page.","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Request rejected; JSON contains an error message."},"403":{"description":"Request rejected; JSON contains an error message."}}}},"/api/artist/website-requests/{id}":{"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"get":{"operationId":"getWebsiteRequest","x-artist-only":true,"x-browser-session-required":true,"responses":{"200":{"description":"Private website request.","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Request rejected; JSON contains an error message."},"403":{"description":"Request rejected; JSON contains an error message."},"404":{"description":"Request rejected; JSON contains an error message."}}},"patch":{"security":[{"csrfToken":[]}],"x-browser-session-required":true,"operationId":"updateWebsiteRequest","x-artist-only":true,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["status","notes","version"],"properties":{"status":{"type":"string","enum":["new","reviewing","contacted","closed"]},"notes":{"type":"string","maxLength":10000},"version":{"type":"integer","minimum":1}}}}}},"responses":{"200":{"description":"Website request updated.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Request rejected; JSON contains an error message."},"401":{"description":"Request rejected; JSON contains an error message."},"403":{"description":"Request rejected; JSON contains an error message."},"409":{"description":"Request rejected; JSON contains an error message."}}}}},"components":{"securitySchemes":{"csrfToken":{"type":"apiKey","in":"header","name":"X-CSRF-Token","description":"Session-bound token from GET /api/session. Requires the matching browser session cookie and a same-origin request; staff writes additionally require artist sign-in."}},"schemas":{"BookingDetails":{"type":"object","additionalProperties":false,"required":["name","email","idea","placement","size","project","style","color"],"properties":{"name":{"type":"string","maxLength":80,"minLength":1},"email":{"type":"string","maxLength":254,"minLength":1,"format":"email"},"phone":{"type":"string","maxLength":40},"instagram":{"type":"string","maxLength":80},"project":{"type":"string","maxLength":30,"minLength":1,"enum":["New tattoo","Cover-up","Rework / refresh"]},"style":{"type":"string","maxLength":60,"minLength":1,"enum":["Anime & manga","Pop culture & gaming","Neo-traditional / illustrative","Black & grey","Let's discuss"]},"color":{"type":"string","maxLength":40,"minLength":1,"enum":["Full color","Black & grey","Open to suggestions"]},"idea":{"type":"string","maxLength":2000,"minLength":1},"placement":{"type":"string","maxLength":100,"minLength":1},"size":{"type":"string","maxLength":80,"minLength":1},"budget":{"type":"string","maxLength":100},"availability":{"type":"string","maxLength":200},"references":{"type":"string","maxLength":1500},"existing":{"type":"string","maxLength":1200},"existing-size":{"type":"string","maxLength":80},"tattoo-age":{"type":"string","maxLength":60},"laser":{"type":"string","maxLength":30,"enum":["Not specified","No","Yes"]},"flexibility":{"type":"string","maxLength":60,"enum":["Let's discuss","Flexible on both","Flexible on size","Flexible on subject","Specific size and subject"]},"notes":{"type":"string","maxLength":1200},"inspirationId":{"type":["string","null"],"description":"A stable portfolio ID from the catalog, or null."}},"allOf":[{"if":{"properties":{"project":{"enum":["Cover-up","Rework / refresh"]}},"required":["project"]},"then":{"required":["existing"],"properties":{"existing":{"minLength":1}}}}]}}}}