API Surface Map - Tattoo Developers

Use https://api.tattooapi.com for new integrations. Studio, artist, search, portfolio, and design reads require api-version=2026-07-01-preview.

Public Reads

Endpoint	Function
`GET /health/live`	Check API availability
`GET /health/ready`	Check readiness
`GET /studios`	Browse studio records

Authenticated Beta Reads

Approved credentials and a mapped TattooAPI actor are required.

Endpoint	Function
GET /search	Unified discovery across studios, artists, and designs.
GET /artists	Approved artist catalog.
GET /artists/	Approved artist detail.
GET /portfolios	Public creative projection only.
GET /portfolios/	Public creative projection only.
GET /designs	Public design projection only.
GET /designs/	Public design projection only.

Owner Reads

These endpoints return only the caller’s authorized artist or studio records. Keep private responses server-side.

Endpoint	Function
GET /api/v1/me/portfolio-assets	Owner-filtered portfolio assets across draft/private/public states.
GET /api/v1/me/portfolio-assets/	Owner-filtered portfolio asset detail.
GET /api/v1/me/designs	Owner-filtered designs across private/public states.
GET /api/v1/me/designs/	Owner-filtered design detail.

Portfolio Intake

Approved integrations can resolve artist identity, create media submissions, complete uploads, and retrieve submission status. Review requires separate permissions. See Portfolio Intake Workflow.

Limits

Public writes are blocked. Upload completion and approval do not automatically publish media. Local API-key management is retired; manage credentials in the partner portal. Existing clients may continue to use the /api/v1 compatibility base. Unlisted routes are not supported integration contracts. See API Access Model and API Availability.