# The Agents Gift Shop — List My Designs

> The Agents Gift Shop — List My Designs is a paid API for AI agents from www.theagentsgiftshop.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-20).

Retrieves a paginated list of the authenticated agent's saved merchandise designs, including status, product type, and pricing details.

## Facts

- Endpoint: GET https://www.theagentsgiftshop.com/v1/me/designs?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/the-agents-gift-shop-list-my-designs-b094ea08
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_sB8F-C085PGzNnmZElVOD

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability the-agents-gift-shop-list-my-designs-b094ea08
```

Example prompt: Can you pull up all my current designs from The Agents Gift Shop — show me up to 50, starting from the beginning — so I can see which ones are queued and what they cost?

## When to prefer this

Use this endpoint when you need to enumerate, audit, or monitor the agent's existing designs before taking action (e.g., reordering, polling for completion, or retrieving design keys). It is the canonical way to discover what designs exist and their current statuses. Prefer this over individual design lookups when you don't yet know the design_id.

## Known failure modes

- Payment failure via x402 if USDC balance is insufficient (402 response)
- Invalid pagination parameters (limit out of 1–100 range or negative offset) returning 400
- Unauthenticated requests returning 401
- Empty items array if no designs exist yet
- Rate limiting if called too frequently in succession

## How this service works

Custom print-on-demand merchandise for autonomous agents, paid per call with x402 (USDC on Base). Describe a design, get artwork and mockups, order it printed and shipped.

## Output

Returns a JSON object with an 'items' array of design records (each containing design_id, design_key, status, product_type, price_cents, and a poll URL), plus a 'total' count and schema version. Design keys are shown once and must be stored for subsequent requests.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "limit": {
       "type": "integer",
       "default": 50,
       "maximum": 100,
       "minimum": 1
      },
      "offset": {
       "type": "integer",
       "default": 0,
       "minimum": 0
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "items": [
   {
    "poll": "/v1/designs/5d1d7a2e-5c8f-4c3a-9f0e-2c3d4e5f6a7b",
    "schema": "tags_v1",
    "status": "queued",
    "design_id": "5d1d7a2e-5c8f-4c3a-9f0e-2c3d4e5f6a7b",
    "design_key": "dk_…(shown once; send as X-Design-Key)",
    "price_cents": 2500,
    "product_type": "shirts"
   }
  ],
  "total": 1,
  "schema": "tags_v1"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/the-agents-gift-shop-list-my-designs-b094ea08/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.theagentsgiftshop.com](https://www.zero.xyz/host/www.theagentsgiftshop.com/llms.txt)
