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

# My Portfolio Assets

> Authenticated owner projection for portfolio assets.

<Note>
  **Posture:** Owner-scoped private beta. Requires approved authentication plus TattooAPI actor mapping to the owning studio or artist.
</Note>

<Warning>
  **Write boundary:** Owner writes return `owner_write_gated` until the governed mutation contract is approved and activated.
</Warning>

Canonical request URL: `https://api.tattooapi.com/api/v1/me/portfolio-assets`.

# My Portfolio Assets

`GET /me/portfolio-assets` is an authenticated owner-scoped read-beta endpoint.

It can return records owned by the authenticated artist or studio across these publish states:

* `draft`
* `owner_private`
* `published_public`

## Auth

```bash theme={"dark"}
curl "$TATTOO_API_BASE_URL/me/portfolio-assets?limit=20" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
```

## Query Parameters

| Parameter   | Type    | Notes                          |
| ----------- | ------- | ------------------------------ |
| `page`      | integer | Default `1`                    |
| `limit`     | integer | Default `20`, max `100`        |
| `artist_id` | string  | Filter own assets by artist id |
| `style_id`  | string  | Filter own assets by style id  |
| `featured`  | boolean | `true` or `false`              |
| `tags`      | string  | Comma-separated tag filter     |

## Access Rules

* The caller must resolve to an owner-scoped creative actor.
* The endpoint is owner-filtered.
* One studio cannot read another studio's private or draft creative records through this route.

## Write Boundary

`POST`, `PUT`, `PATCH`, and `DELETE` return `owner_write_gated`.

The route is read-capable now; live owner mutations are not active yet.