Amo.ng Public API

Quick start

Base URL: https://amo.ng/api/v1

No API key, account, or authentication is required. Version 1 is read-only and supports GET and HEAD requests only.

Start with GET /api/v1/prompts?per_page=5 to browse five published Prompts, then retrieve one by Amo ID or slug. Anonymous requests are limited to 60 per minute per IP.

Resources

• GET /api/v1/prompts — browse published Prompts.
• GET /api/v1/prompts/{amo-id-or-slug} — retrieve a current published Prompt.
• GET /api/v1/workflows — browse published Workflows.
• GET /api/v1/workflows/{amo-id-or-slug} — retrieve a published Workflow and its ordered steps.
• GET /api/v1/skills — browse published Skills.
• GET /api/v1/skills/{amo-id-or-slug} — retrieve a published Skill and its source reference.

Pagination and filters

Collections return data and meta. They accept page and per_page; the default page size is 20 and the maximum is 100.

Prompt filters: q, category, difficulty, tool, type, and outcome. Supported Outcome values are build, fix, automate, analyze, plan, and learn. Workflows accept q. Skills accept q and source_type=prompt|workflow.

Response shape

Detail responses use a data envelope. Stable IDs such as AMO-P-000001, AMO-W-000001, and AMO-S-000001 are the primary external identifiers; slugs are also accepted.

{
  "data": {
    "amo_id": "AMO-W-000001",
    "title": "...",
    "steps": [
      {
        "step": 1,
        "review_note": "The release owner approves deployment.",
        "prompt": { "amo_id": "AMO-P-000001", "title": "...", "url": "..." }
      }
    ],
    "url": "https://amo.ng/workflows/..."
  }
}

Prompt details are sourced from the exact current published PromptVersion and include version. Workflow review guidance uses review_note. Skill details expose the stored public capability and a lightweight Prompt or Workflow source.

Errors, caching, and browser access

Errors use a stable error object with a short code such as not_found, invalid_request, or rate_limit_exceeded. Internal exception details are not returned.

{
  "error": {
    "code": "not_found",
    "message": "Resource not found."
  }
}

Successful responses are publicly cacheable for 60 seconds and include an ETag for conditional requests. Cross-origin GET, HEAD, and preflight OPTIONS requests are allowed without credentials; write methods are not enabled.

Public-content boundaries

Only currently published content is returned. Drafts, future-dated content, unpublished PromptVersions, internal numeric IDs, modernization history, private quality evidence, provider data, and admin metadata are excluded.

Responses include the canonical Amo.ng url. When presenting an Amo.ng asset elsewhere, retain that link so readers can find the current public source.

Use with MCP

Connect a compatible AI or developer client to discover published assets and retrieve a specific current public asset by its stable Amo ID or slug. MCP calls do not execute Prompts or mutate Amo.ng.

Learn how to connect Amo.ng to compatible AI tools.