Skip to main content
GET
/
designs
List Designs
curl --request GET \
  --url https://api.example.com/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: 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 Designs

GET /designs is an authenticated read-beta endpoint. It returns public design projections only. Private, draft, and owner-only creative records are not included.

​
Auth

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

​
Query Parameters

ParameterTypeNotes
pageintegerDefault 1
limitintegerDefault 20, max 100
artist_idstringFilter by runtime artist id
style_idstringFilter by style id
publicbooleanfalse returns no records on the public route
tagsstringComma-separated tag filter
searchstringTitle and description search
min_price, max_pricenumberOptional price filters when price exists

​
Response Shape

{
  "success": true,
  "data": [
    {
      "id": "design:ashlewis-instagram-overlay-2026-04-20",
      "title": "Black and grey healed sleeve",
      "image_url": "https://example.com/image.jpg",
      "artist_id": "artist:example",
      "tags": ["black_and_grey"],
      "is_public": true,
      "publish_state": "published_public",
      "provenance": {},
      "trust": {},
      "runtime_trust_proof": {}
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 1,
    "totalPages": 1
  }
}

​
Write Boundary

POST, PUT, PATCH, and DELETE are explicitly blocked on this public route family. Design mutation belongs in a future owner-scoped contract, not the public route.