Skip to main content
GET
/
artists
List Artists
curl --request GET \
  --url https://api.example.com/artists

Documentation Index

Fetch the complete documentation index at: https://docs.tattoo.dev/llms.txt

Use this file to discover all available pages before exploring further.

Posture: WorkOS-authenticated internal beta. The caller must resolve to a mapped TattooAPI actor before access is granted.
Write boundary: Public writes are blocked. Do not build production flows assuming mutation is live on this route family.

​
List Artists

GET /artists is an authenticated internal-beta read endpoint. It returns runtime-backed ArtistProfile records for team, SDK, and operator development. This is not promoted as a no-auth public endpoint yet.

​
Auth

Use a WorkOS/AuthKit bearer token or a WorkOS API key mapped to a TattooAPI actor. 
curl "$TATTOO_API_BASE_URL/artists?limit=20" \
  -H "X-API-Key: YOUR_WORKOS_API_KEY"

​
Query Parameters

ParameterTypeNotes
pageintegerDefault 1
limitintegerDefault 20, max 100
studio_idstringFilter by studio id
specialtystringFilter by specialty
min_experiencenumberMinimum years of experience
max_hourly_ratenumberMaximum hourly rate when present
is_activebooleanFilter by active state
searchstringName, bio, and specialty search
sort_bystringname, years_experience, hourly_rate, or created_at
sort_orderstringasc or desc

​
Response Shape

{
  "success": true,
  "data": [
    {
      "id": "artist:example",
      "name": "Example Artist",
      "studio_id": "studio:example",
      "specialties": ["black_and_grey"],
      "is_active": true,
      "created_at": "2026-04-30T00:00:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 1,
    "pages": 1
  }
}

​
Write Boundary

POST is explicitly blocked on this route. Public artist writes are not active. Artist profile mutation belongs to governed internal profile-review contracts first, then later owner-scoped contracts after the access model is proven.