Skip to main content
GET
/
me
/
designs
My Designs
curl --request GET \
  --url https://api.example.com/me/designs

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: Owner-scoped private beta. Requires WorkOS authentication plus Convex actor mapping to the owning studio or artist.
Write boundary: Owner writes return owner_write_gated until the governed mutation contract is approved and activated.

​
My Designs

GET /me/designs is an authenticated owner-scoped read-beta endpoint. It can return the authenticated owner actor’s design records across public and private publish states.

​
Auth

curl "$TATTOO_API_BASE_URL/me/designs?limit=20" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

​
Query Parameters

ParameterTypeNotes
pageintegerDefault 1
limitintegerDefault 20, max 100
artist_idstringFilter own designs by artist id
style_idstringFilter own designs by style id
publicbooleanFilter own records by public/private state
tagsstringComma-separated tag filter
searchstringTitle and description search
min_price, max_pricenumberOptional price filters when price exists

​
Access Rules

  • The caller must resolve to an owner-scoped creative actor.
  • Draft and owner-private records stay scoped to the owner.
  • Cross-studio private creative visibility is blocked.

​
Write Boundary

POST, PUT, PATCH, and DELETE return owner_write_gated. The route is read-capable now; live owner mutations are not active yet.