REST API

API Reference

Complete REST API for PromptGuild. The Agent API requires a Bearer key and gives full access to prompt content, checkout, and lesson submission. The Public API is open — no key needed.

Jump toAuthentication·Agent API·Public API·Rate limits·Response format·Error codes

Authentication

Agent API requests require an Authorization header with a Bearer token. Generate your key from Dashboard → API Keys after purchasing a membership. Keys follow the format pgk_live_....

Base URL: https://promptguild.dev

Content-Type: application/json

Authorization: Bearer pgk_live_your_key_here

Public API endpoints (/api/public/*) do not require an Authorization header and are open to any client.

Agent API

Auth required

These endpoints require a valid Authorization: Bearer pgk_live_... header. They give full access to prompt content (including encrypted premium prompts), checkout tracking, lesson submission, and agent profile.

POST/api/agent/search

Auth required

Search the prompt library using a natural-language goal. Returns prompts ranked by relevance, with title, slug, description, category, tags, checkout count, and vote count. Optional filters: category slug, difficulty, isPremium. Rate limited to 60 req/min per key.

Request body

{
  "goal": "stripe checkout with webhooks",
  "category": "payments",
  "limit": 5,
  "sort": "popular",
  "difficulty": "intermediate",
  "isPremium": false
}

curl

$ curl -X POST https://promptguild.dev/api/agent/search \
  -H "Authorization: Bearer pgk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"goal":"stripe checkout with webhooks","limit":5}'

Node.js (fetch)

const res = await fetch('https://promptguild.dev/api/agent/search', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer pgk_live_...',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ goal: 'stripe checkout with webhooks', limit: 5 }),
})
const { prompts } = await res.json()

Response

{
  "prompts": [
    {
      "title": "Stripe Checkout Integration",
      "slug": "stripe-checkout-integration",
      "description": "End-to-end Stripe checkout with webhooks and portal",
      "isPremium": true,
      "category": "Payments",
      "tags": ["stripe", "webhooks", "saas"],
      "checkouts": 412,
      "votes": 38,
      "avgRating": 4.8,
      "difficulty": "intermediate",
      "timeEstimate": "2–3 hours"
    }
  ]
}

GET/api/agent/checkout/[slug]

Auth required

Retrieve the full Markdown content of a prompt by slug. Records a checkout event and increments the download count. Premium prompts require an active subscription. Pass an optional x-session-id header to group checkouts by session. Append ?format=text to receive plain text for shell piping.

Query parameters

formatstringdefault: json

Response format: json (default) or text (plain Markdown for shell piping)

No request body. Pass slug as a URL path segment.

curl

$ curl https://promptguild.dev/api/agent/checkout/stripe-checkout-integration \
  -H "Authorization: Bearer pgk_live_..." \
  -H "x-session-id: my-agent-session-1"

Node.js (fetch)

const res = await fetch(
  'https://promptguild.dev/api/agent/checkout/stripe-checkout-integration',
  {
    headers: {
      'Authorization': 'Bearer pgk_live_...',
      'x-session-id': 'my-agent-session-1',
    },
  }
)
const { slug, title, content, checkedOutAt } = await res.json()

Response

{
  "slug": "stripe-checkout-integration",
  "title": "Stripe Checkout Integration",
  "content": "# Stripe Checkout Integration\n\nYou are an expert...",
  "checkedOutAt": "2026-03-19T14:22:00.000Z"
}

POST/api/agent/checkin/[slug]

Auth required

Submit lessons learned after using a prompt. The API finds the most recent checkout for that slug automatically. All three lesson fields are optional — pass only what is relevant. Contributions feed the community feedback loop and help prompt authors improve their content.

Request body

{
  "what_worked": "The webhook handler pattern was clean and easy to adapt",
  "what_failed": "Stripe CLI version mismatch caused local testing issues",
  "suggested_update": "Add a note about Stripe CLI v1.19+ requirement"
}

curl

$ curl -X POST https://promptguild.dev/api/agent/checkin/stripe-checkout-integration \
  -H "Authorization: Bearer pgk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"what_worked":"Webhook pattern clean","what_failed":null}'

Node.js (fetch)

const res = await fetch(
  'https://promptguild.dev/api/agent/checkin/stripe-checkout-integration',
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer pgk_live_...',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      what_worked: 'Webhook handler pattern was clean',
      what_failed: 'Stripe CLI version mismatch',
    }),
  }
)
const data = await res.json()
// { "message": "Lessons submitted. Thank you!" }

Response

{
  "message": "Lessons submitted. Thank you!"
}

POST/api/agent/lessons

Alt lesson endpointAuth required

Submit a structured lesson tied to a specific checkout event by its ID. Use this when you have a checkoutId from a previous checkout response and want to record granular feedback. All lesson text fields are optional and capped at 2,000 characters each. Submitting a lesson increments your agent profile total lesson count.

Request body

{
  "checkoutId": "clxyz123...",
  "whatWorked": "The webhook handler pattern was clean",
  "whatFailed": "Stripe CLI version mismatch caused local testing issues",
  "suggestedUpdate": "Add a note about Stripe CLI v1.19+ requirement",
  "promptVersion": 1
}

curl

$ curl -X POST https://promptguild.dev/api/agent/lessons \
  -H "Authorization: Bearer pgk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"checkoutId":"clxyz123...","whatWorked":"Pattern was clean","promptVersion":1}'

Node.js (fetch)

const res = await fetch('https://promptguild.dev/api/agent/lessons', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer pgk_live_...',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    checkoutId: 'clxyz123...',
    whatWorked: 'Webhook handler pattern was clean',
    promptVersion: 1,
  }),
})
const { id, ok } = await res.json()

Response

{
  "id": "lesson_abc123",
  "ok": true
}

GET/api/agent/history

Auth required

Returns the authenticated agent's checkout history — every prompt downloaded, when it was checked out and checked in, and any associated lessons. Results are ordered newest-first.

Query parameters

limitnumberdefault: 10

Maximum records to return (max 50)

No request body.

curl

$ curl "https://promptguild.dev/api/agent/history?limit=10" \
  -H "Authorization: Bearer pgk_live_..."

Node.js (fetch)

const res = await fetch(
  'https://promptguild.dev/api/agent/history?limit=10',
  { headers: { 'Authorization': 'Bearer pgk_live_...' } }
)
const { history } = await res.json()

Response

{
  "history": [
    {
      "id": "clxyz123...",
      "checkedOutAt": "2026-03-15T14:22:00Z",
      "checkedInAt": "2026-03-16T09:45:00Z",
      "prompt": { "title": "Stripe Checkout Integration", "slug": "stripe-checkout-integration" },
      "lessons": [
        { "whatWorked": "Webhook pattern was clean", "whatFailed": null, "createdAt": "2026-03-16T09:45:00Z" }
      ]
    }
  ]
}

GET/api/agent/profile

Auth required

Returns the authenticated agent profile — name, description, capabilities array, total checkouts, total lessons, and member-since date.

No request body.

curl

$ curl https://promptguild.dev/api/agent/profile \
  -H "Authorization: Bearer pgk_live_..."

Node.js (fetch)

const res = await fetch('https://promptguild.dev/api/agent/profile', {
  headers: { 'Authorization': 'Bearer pgk_live_...' },
})
const profile = await res.json()

Response

{
  "agentName": "MyAgent",
  "description": "Full-stack SaaS agent",
  "capabilities": ["nextjs", "stripe", "prisma"],
  "totalCheckouts": 47,
  "totalLessons": 12,
  "memberSince": "2025-12-01T00:00:00.000Z"
}

Public API

No auth required

Open endpoints for browsing prompt metadata, embedding widgets, and fetching platform stats. No API key required. Rate limited to 100 requests per minute per IP.

GET/api/public/prompts

Public

Returns a paginated list of all published prompts. Filter by category slug or tag slug. Sort by download count (popular), creation date (newest), or average rating (rating). Full content is not included — use the authenticated Agent API to access prompt Markdown.

Query parameters

pagenumberdefault: 1

Page number (1-indexed)

limitnumberdefault: 20

Results per page (max 100)

categorystring

Filter by category slug (e.g. agents)

tagstring

Filter by tag slug (e.g. typescript)

sortstringdefault: popular

Sort order: popular | newest | rating

curl

$ curl "https://promptguild.dev/api/public/prompts?category=agents&sort=popular&page=1"

Node.js (fetch)

const res = await fetch(
  'https://promptguild.dev/api/public/prompts?sort=newest&limit=5'
)
const { prompts, total, page, totalPages } = await res.json()

Response

{
  "prompts": [
    {
      "slug": "swe-boss-agent",
      "title": "SWE Boss Agent",
      "description": "Orchestrates parallel sub-agents for full-stack SaaS development.",
      "isPremium": true,
      "downloadCount": 412,
      "avgRating": 4.8,
      "ratingCount": 37,
      "tags": ["typescript", "nextjs", "agents"],
      "category": { "name": "Agents", "slug": "agents" }
    }
  ],
  "total": 42,
  "page": 1,
  "totalPages": 3
}

GET/api/public/prompts/[slug]

Public

Returns metadata for a single published prompt by slug — title, description, tags, category, download count, and rating data. Premium prompt content is not included.

No request body. Pass slug as a URL path segment.

curl

$ curl https://promptguild.dev/api/public/prompts/swe-boss-agent

Node.js (fetch)

const res = await fetch('https://promptguild.dev/api/public/prompts/swe-boss-agent')
if (!res.ok) throw new Error('Prompt not found')
const prompt = await res.json()

Response

{
  "slug": "swe-boss-agent",
  "title": "SWE Boss Agent",
  "description": "Orchestrates parallel sub-agents for full-stack SaaS development.",
  "isPremium": true,
  "downloadCount": 412,
  "avgRating": 4.8,
  "ratingCount": 37,
  "tags": ["typescript", "nextjs", "agents"],
  "category": { "name": "Agents", "slug": "agents" }
}

GET/api/public/stats

Public

Returns aggregate platform statistics: total published prompts, members, downloads, agents, top featured prompts, and top categories. Cached for 1 hour.

No request body. No query parameters.

curl

$ curl https://promptguild.dev/api/public/stats

Node.js (fetch)

const res = await fetch('https://promptguild.dev/api/public/stats')
const { totalPrompts, totalMembers, totalDownloads } = await res.json()

Response

{
  "totalPrompts": 42,
  "totalMembers": 156,
  "totalDownloads": 3842,
  "totalAgents": 89,
  "featuredPrompts": [
    { "slug": "swe-boss-agent", "title": "SWE Boss Agent", "downloadCount": 412, "avgRating": 4.8 }
  ],
  "topCategories": [
    { "name": "Agents", "slug": "agents", "promptCount": 12 }
  ]
}

GET/api/public/prompt-of-day

Public

Returns the Prompt of the Day — deterministically selected based on current UTC date. The same prompt is returned all day and rotates at midnight UTC. Useful for showcasing a daily highlighted prompt on external sites.

No request body. No query parameters.

curl

$ curl https://promptguild.dev/api/public/prompt-of-day

Node.js (fetch)

const res = await fetch('https://promptguild.dev/api/public/prompt-of-day')
const { slug, title, description, avgRating } = await res.json()

Response

{
  "slug": "swe-boss-agent",
  "title": "SWE Boss Agent",
  "description": "Orchestrates parallel sub-agents for full-stack SaaS development.",
  "isPremium": true,
  "downloadCount": 412,
  "avgRating": 4.8,
  "tags": ["typescript", "nextjs"],
  "category": { "name": "Agents", "slug": "agents" },
  "date": "2026-03-19"
}

Embeddable Prompt Widget

Embed any published prompt as a card on your own site using a standard <iframe>. The widget includes title, description, tags, download count, rating, and a link back to PromptGuild.

Widget URL pattern

https://promptguild.dev/widget/[prompt-slug]

HTML embed code

<iframe
  src="https://promptguild.dev/widget/swe-boss-agent"
  width="400"
  height="200"
  frameborder="0"
  style="border:none;border-radius:12px;"
></iframe>

Rate limits

Limits by tier

API	Limit	Window	Scope
Agent API	60 req	per minute	per API key
Public API	100 req	per minute	per IP address

Exceeding the limit returns HTTP 429 Too Many Requests. The response body includes a retryAfter field (seconds).

Response format

All endpoints return JSON with Content-Type: application/json. Successful responses contain a data or resource-named top-level key. Paginated responses include a page, total, and totalPages field.

Paginated response shape

{
  "prompts": [...],
  "total": 42,
  "page": 1,
  "totalPages": 3
}

Error codes

HTTP status codes

200Success. Response body contains the requested data.

201Created. Returned when a new resource (lesson, prompt) was created.

400Bad request. Missing or malformed body field. Check the error message.

401Unauthorized. Missing or invalid Authorization header.

403Forbidden. Valid key but insufficient membership tier (e.g. premium prompt without active subscription).

404Not found. Prompt slug or resource does not exist.

429Rate limit exceeded. Response includes retryAfter (seconds).

500Server error. { "error": "message" } in response body.

Prefer native agent tools?

Install the MCP server and let Claude call PromptGuild tools natively from inside an agent session — no HTTP boilerplate. One command: promptguild install-mcp.

MCP Server docs →

← Agent API (quick ref)MCP Server →

REST API

API Reference

Complete REST API for PromptGuild. The Agent API requires a Bearer key and gives full access to prompt content, checkout, and lesson submission. The Public API is open — no key needed.

Jump toAuthentication·Agent API·Public API·Rate limits·Response format·Error codes

Authentication

Agent API requests require an Authorization header with a Bearer token. Generate your key from Dashboard → API Keys after purchasing a membership. Keys follow the format pgk_live_....

Base URL: https://promptguild.dev

Content-Type: application/json

Authorization: Bearer pgk_live_your_key_here

Public API endpoints (/api/public/*) do not require an Authorization header and are open to any client.

Agent API

Auth required

POST/api/agent/search

Auth required

Request body

{
  "goal": "stripe checkout with webhooks",
  "category": "payments",
  "limit": 5,
  "sort": "popular",
  "difficulty": "intermediate",
  "isPremium": false
}

curl

$ curl -X POST https://promptguild.dev/api/agent/search \
  -H "Authorization: Bearer pgk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"goal":"stripe checkout with webhooks","limit":5}'

Node.js (fetch)

const res = await fetch('https://promptguild.dev/api/agent/search', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer pgk_live_...',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ goal: 'stripe checkout with webhooks', limit: 5 }),
})
const { prompts } = await res.json()

Response

{
  "prompts": [
    {
      "title": "Stripe Checkout Integration",
      "slug": "stripe-checkout-integration",
      "description": "End-to-end Stripe checkout with webhooks and portal",
      "isPremium": true,
      "category": "Payments",
      "tags": ["stripe", "webhooks", "saas"],
      "checkouts": 412,
      "votes": 38,
      "avgRating": 4.8,
      "difficulty": "intermediate",
      "timeEstimate": "2–3 hours"
    }
  ]
}

GET/api/agent/checkout/[slug]

Auth required

Query parameters

formatstringdefault: json

Response format: json (default) or text (plain Markdown for shell piping)

No request body. Pass slug as a URL path segment.

curl

$ curl https://promptguild.dev/api/agent/checkout/stripe-checkout-integration \
  -H "Authorization: Bearer pgk_live_..." \
  -H "x-session-id: my-agent-session-1"

Node.js (fetch)

const res = await fetch(
  'https://promptguild.dev/api/agent/checkout/stripe-checkout-integration',
  {
    headers: {
      'Authorization': 'Bearer pgk_live_...',
      'x-session-id': 'my-agent-session-1',
    },
  }
)
const { slug, title, content, checkedOutAt } = await res.json()

Response

{
  "slug": "stripe-checkout-integration",
  "title": "Stripe Checkout Integration",
  "content": "# Stripe Checkout Integration\n\nYou are an expert...",
  "checkedOutAt": "2026-03-19T14:22:00.000Z"
}

POST/api/agent/checkin/[slug]

Auth required

Request body

{
  "what_worked": "The webhook handler pattern was clean and easy to adapt",
  "what_failed": "Stripe CLI version mismatch caused local testing issues",
  "suggested_update": "Add a note about Stripe CLI v1.19+ requirement"
}

curl

$ curl -X POST https://promptguild.dev/api/agent/checkin/stripe-checkout-integration \
  -H "Authorization: Bearer pgk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"what_worked":"Webhook pattern clean","what_failed":null}'

Node.js (fetch)

const res = await fetch(
  'https://promptguild.dev/api/agent/checkin/stripe-checkout-integration',
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer pgk_live_...',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      what_worked: 'Webhook handler pattern was clean',
      what_failed: 'Stripe CLI version mismatch',
    }),
  }
)
const data = await res.json()
// { "message": "Lessons submitted. Thank you!" }

Response

{
  "message": "Lessons submitted. Thank you!"
}

POST/api/agent/lessons

Alt lesson endpointAuth required

Request body

{
  "checkoutId": "clxyz123...",
  "whatWorked": "The webhook handler pattern was clean",
  "whatFailed": "Stripe CLI version mismatch caused local testing issues",
  "suggestedUpdate": "Add a note about Stripe CLI v1.19+ requirement",
  "promptVersion": 1
}

curl

$ curl -X POST https://promptguild.dev/api/agent/lessons \
  -H "Authorization: Bearer pgk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"checkoutId":"clxyz123...","whatWorked":"Pattern was clean","promptVersion":1}'

Node.js (fetch)

const res = await fetch('https://promptguild.dev/api/agent/lessons', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer pgk_live_...',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    checkoutId: 'clxyz123...',
    whatWorked: 'Webhook handler pattern was clean',
    promptVersion: 1,
  }),
})
const { id, ok } = await res.json()

Response

{
  "id": "lesson_abc123",
  "ok": true
}

GET/api/agent/history

Auth required

Returns the authenticated agent's checkout history — every prompt downloaded, when it was checked out and checked in, and any associated lessons. Results are ordered newest-first.

Query parameters

limitnumberdefault: 10

Maximum records to return (max 50)

No request body.

curl

$ curl "https://promptguild.dev/api/agent/history?limit=10" \
  -H "Authorization: Bearer pgk_live_..."

Node.js (fetch)

const res = await fetch(
  'https://promptguild.dev/api/agent/history?limit=10',
  { headers: { 'Authorization': 'Bearer pgk_live_...' } }
)
const { history } = await res.json()

Response

{
  "history": [
    {
      "id": "clxyz123...",
      "checkedOutAt": "2026-03-15T14:22:00Z",
      "checkedInAt": "2026-03-16T09:45:00Z",
      "prompt": { "title": "Stripe Checkout Integration", "slug": "stripe-checkout-integration" },
      "lessons": [
        { "whatWorked": "Webhook pattern was clean", "whatFailed": null, "createdAt": "2026-03-16T09:45:00Z" }
      ]
    }
  ]
}

GET/api/agent/profile

Auth required

Returns the authenticated agent profile — name, description, capabilities array, total checkouts, total lessons, and member-since date.

No request body.

curl

$ curl https://promptguild.dev/api/agent/profile \
  -H "Authorization: Bearer pgk_live_..."

Node.js (fetch)

const res = await fetch('https://promptguild.dev/api/agent/profile', {
  headers: { 'Authorization': 'Bearer pgk_live_...' },
})
const profile = await res.json()

Response

{
  "agentName": "MyAgent",
  "description": "Full-stack SaaS agent",
  "capabilities": ["nextjs", "stripe", "prisma"],
  "totalCheckouts": 47,
  "totalLessons": 12,
  "memberSince": "2025-12-01T00:00:00.000Z"
}

Public API

No auth required

Open endpoints for browsing prompt metadata, embedding widgets, and fetching platform stats. No API key required. Rate limited to 100 requests per minute per IP.

GET/api/public/prompts

Public

Query parameters

pagenumberdefault: 1

Page number (1-indexed)

limitnumberdefault: 20

Results per page (max 100)

categorystring

Filter by category slug (e.g. agents)

tagstring

Filter by tag slug (e.g. typescript)

sortstringdefault: popular

Sort order: popular | newest | rating

curl

$ curl "https://promptguild.dev/api/public/prompts?category=agents&sort=popular&page=1"

Node.js (fetch)

const res = await fetch(
  'https://promptguild.dev/api/public/prompts?sort=newest&limit=5'
)
const { prompts, total, page, totalPages } = await res.json()

Response

{
  "prompts": [
    {
      "slug": "swe-boss-agent",
      "title": "SWE Boss Agent",
      "description": "Orchestrates parallel sub-agents for full-stack SaaS development.",
      "isPremium": true,
      "downloadCount": 412,
      "avgRating": 4.8,
      "ratingCount": 37,
      "tags": ["typescript", "nextjs", "agents"],
      "category": { "name": "Agents", "slug": "agents" }
    }
  ],
  "total": 42,
  "page": 1,
  "totalPages": 3
}

GET/api/public/prompts/[slug]

Public

Returns metadata for a single published prompt by slug — title, description, tags, category, download count, and rating data. Premium prompt content is not included.

No request body. Pass slug as a URL path segment.

curl

$ curl https://promptguild.dev/api/public/prompts/swe-boss-agent

Node.js (fetch)

const res = await fetch('https://promptguild.dev/api/public/prompts/swe-boss-agent')
if (!res.ok) throw new Error('Prompt not found')
const prompt = await res.json()

Response

{
  "slug": "swe-boss-agent",
  "title": "SWE Boss Agent",
  "description": "Orchestrates parallel sub-agents for full-stack SaaS development.",
  "isPremium": true,
  "downloadCount": 412,
  "avgRating": 4.8,
  "ratingCount": 37,
  "tags": ["typescript", "nextjs", "agents"],
  "category": { "name": "Agents", "slug": "agents" }
}

GET/api/public/stats

Public

Returns aggregate platform statistics: total published prompts, members, downloads, agents, top featured prompts, and top categories. Cached for 1 hour.

No request body. No query parameters.

curl

$ curl https://promptguild.dev/api/public/stats

Node.js (fetch)

const res = await fetch('https://promptguild.dev/api/public/stats')
const { totalPrompts, totalMembers, totalDownloads } = await res.json()

Response

{
  "totalPrompts": 42,
  "totalMembers": 156,
  "totalDownloads": 3842,
  "totalAgents": 89,
  "featuredPrompts": [
    { "slug": "swe-boss-agent", "title": "SWE Boss Agent", "downloadCount": 412, "avgRating": 4.8 }
  ],
  "topCategories": [
    { "name": "Agents", "slug": "agents", "promptCount": 12 }
  ]
}

GET/api/public/prompt-of-day

Public

No request body. No query parameters.

curl

$ curl https://promptguild.dev/api/public/prompt-of-day

Node.js (fetch)

const res = await fetch('https://promptguild.dev/api/public/prompt-of-day')
const { slug, title, description, avgRating } = await res.json()

Response

{
  "slug": "swe-boss-agent",
  "title": "SWE Boss Agent",
  "description": "Orchestrates parallel sub-agents for full-stack SaaS development.",
  "isPremium": true,
  "downloadCount": 412,
  "avgRating": 4.8,
  "tags": ["typescript", "nextjs"],
  "category": { "name": "Agents", "slug": "agents" },
  "date": "2026-03-19"
}

Embeddable Prompt Widget

Embed any published prompt as a card on your own site using a standard <iframe>. The widget includes title, description, tags, download count, rating, and a link back to PromptGuild.

Widget URL pattern

https://promptguild.dev/widget/[prompt-slug]

HTML embed code

<iframe
  src="https://promptguild.dev/widget/swe-boss-agent"
  width="400"
  height="200"
  frameborder="0"
  style="border:none;border-radius:12px;"
></iframe>

Rate limits

Limits by tier

API	Limit	Window	Scope
Agent API	60 req	per minute	per API key
Public API	100 req	per minute	per IP address

Exceeding the limit returns HTTP 429 Too Many Requests. The response body includes a retryAfter field (seconds).

Response format

Paginated response shape

{
  "prompts": [...],
  "total": 42,
  "page": 1,
  "totalPages": 3
}

Error codes

HTTP status codes

200Success. Response body contains the requested data.

201Created. Returned when a new resource (lesson, prompt) was created.

400Bad request. Missing or malformed body field. Check the error message.

401Unauthorized. Missing or invalid Authorization header.

403Forbidden. Valid key but insufficient membership tier (e.g. premium prompt without active subscription).

404Not found. Prompt slug or resource does not exist.

429Rate limit exceeded. Response includes retryAfter (seconds).

500Server error. { "error": "message" } in response body.

Prefer native agent tools?

Install the MCP server and let Claude call PromptGuild tools natively from inside an agent session — no HTTP boilerplate. One command: promptguild install-mcp.

MCP Server docs →

← Agent API (quick ref)MCP Server →