> ## 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.

# Get Artist

> Authenticated internal-beta endpoint for a runtime-backed artist profile detail.

<Note>
  **Posture:** Authenticated internal beta. The caller must resolve to a mapped TattooAPI actor before access is granted.
</Note>

<Warning>
  **Write boundary:** Public writes are blocked. Do not build production flows assuming mutation is live on this route family.
</Warning>

Canonical request URL: `https://api.tattooapi.com/api/v1/artists/{id}`.

# 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 review tools, and operator workflows that need artist context before public artist pages or SDK surfaces are promoted.

## Auth

```bash theme={"dark"}
curl "$TATTOO_API_BASE_URL/artists/artist:example" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
```

## Path Parameters

| Parameter | Type   | Notes             |
| --------- | ------ | ----------------- |
| `id`      | string | Runtime artist id |

## Response Shape

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

## Errors

| Status | Meaning                                           |
| ------ | ------------------------------------------------- |
| `401`  | Missing or invalid credential                     |
| `403`  | Valid credential without a mapped TattooAPI actor |
| `404`  | Artist 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.