Skip to main content
GET
/
artists
/
{id}
Get Artist
curl --request GET \
  --url https://api.example.com/artists/{id}

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.

​
Get Artist

GET /artists/{id} is an authenticated internal-beta read endpoint. It returns one runtime-backed ArtistProfile detail by id. This is useful for internal SDK skills, creative agents, and operator tools that need artist context before public artist pages or SDK surfaces are promoted.

​
Auth

curl "$TATTOO_API_BASE_URL/artists/artist:example" \
  -H "Authorization: Bearer YOUR_WORKOS_TOKEN"

​
Path Parameters

ParameterTypeNotes
idstringRuntime artist id

​
Response Shape

{
  "success": true,
  "data": {
    "id": "artist:example",
    "name": "Example Artist",
    "studio_id": "studio:example",
    "specialties": ["black_and_grey"],
    "is_active": true
  }
}

​
Errors

StatusMeaning
401Missing or invalid WorkOS credential
403Valid WorkOS credential without a mapped TattooAPI actor
404Artist id not found

​
Write Boundary

PUT and DELETE are explicitly blocked on this public route family. Future artist-owned edits should use an owner-scoped route family, not a broad public mutation endpoint.