# Parse API

## Docs

- [Cancel a task](https://docs.parse.bot/api-reference/dispatch/cancel-a-task.md): Cancel an in-flight build or revision task. Only tasks in a non-terminal state (queued, running, needs_input) can be cancelled.
- [Check for available updates](https://docs.parse.bot/api-reference/dispatch/check-for-available-updates.md): Compare your API against the canonical version to find new or updated endpoints. Returns a list of changes you can preview and merge.
- [Create a new API from a URL](https://docs.parse.bot/api-reference/dispatch/create-a-new-api-from-a-url.md): Submit a website URL to generate an API. If a matching API already exists, returns it instantly. Otherwise, queues a job to build one. Optionally describe the data you need in the `task` field.
- [Get SDK usage example](https://docs.parse.bot/api-reference/dispatch/get-sdk-usage-example.md): Get a code example showing how to call this API using the Parse SDK.
- [Get task detail](https://docs.parse.bot/api-reference/dispatch/get-task-detail.md): Get full details for a dispatch task, including the generated API spec with endpoint definitions and execution URLs when completed.
- [Get the in-flight task for a scraper](https://docs.parse.bot/api-reference/dispatch/get-the-in-flight-task-for-a-scraper.md): Return the active (queued/running/needs_input) revision or extension task for a given scraper, if any. Useful for showing live progress on an API you already own. Returns `{ "task": null }` when nothing is in flight.
- [List revision history](https://docs.parse.bot/api-reference/dispatch/list-revision-history.md): List all revisions (child tasks) for a given task.
- [List your APIs](https://docs.parse.bot/api-reference/dispatch/list-your-apis.md): List all dispatch tasks for the current user, with optional status filter and pagination.
- [Merge updates from canonical](https://docs.parse.bot/api-reference/dispatch/merge-updates-from-canonical.md): Apply selected endpoint updates from the canonical version into your API. New endpoints also merge code; spec-only updates preserve your code.
- [Preview an endpoint update](https://docs.parse.bot/api-reference/dispatch/preview-an-endpoint-update.md): Test an endpoint against the canonical version to see the updated behavior before merging. Returns the execution result plus sample inputs.
- [Respond to input prompts](https://docs.parse.bot/api-reference/dispatch/respond-to-input-prompts.md): Send a response when the agent requests user input during API creation. Task status must be 'needs_input'.
- [Revise a completed API](https://docs.parse.bot/api-reference/dispatch/revise-a-completed-api.md): Submit a revision request for a completed API. Describe what to change — the system will classify and queue the revision.
- [Rollback last merge](https://docs.parse.bot/api-reference/dispatch/rollback-last-merge.md): Restore your API to its pre-merge state. Only the most recent merge can be rolled back.
- [Execute an API endpoint (GET)](https://docs.parse.bot/api-reference/execute/execute-an-api-endpoint-get.md): Call a generated API endpoint using query parameters. Use GET when the endpoint spec defines GET as the method. Parameters are passed as query strings and auto-coerced to the correct types.
- [Execute an API endpoint (POST)](https://docs.parse.bot/api-reference/execute/execute-an-api-endpoint-post.md): Call a generated API endpoint by scraper ID and endpoint name. Pass endpoint parameters in the JSON body.
- [Export as MCP tools](https://docs.parse.bot/api-reference/export/export-as-mcp-tools.md): Export a completed API as MCP (Model Context Protocol) tool definitions. Returns tool names, input schemas, and endpoint metadata.
- [Export as OpenAPI spec](https://docs.parse.bot/api-reference/export/export-as-openapi-spec.md): Export a completed API as an OpenAPI 3.1 JSON document. Includes all endpoints with JSON Schema parameters and response schemas.
- [Fork a marketplace API privately](https://docs.parse.bot/api-reference/marketplace/fork-a-marketplace-api-privately.md): Create a private, desynced copy of the canonical: no upstream merges, and your revisions don't propagate back. Returns a `scraper_id` you own and call at POST /scraper/{scraper_id}/{endpoint_name}.
- [Get a marketplace API's detail](https://docs.parse.bot/api-reference/marketplace/get-a-marketplace-apis-detail.md): Full detail for one marketplace listing, including its `canonical_scraper_id` and endpoint list. No authentication required. Use `canonical_scraper_id` to call the shared canonical directly: POST /scraper/{canonical_scraper_id}/{endpoint_name}.
- [Search and browse the marketplace](https://docs.parse.bot/api-reference/marketplace/search-and-browse-the-marketplace.md): Search the public marketplace of pre-built APIs. No authentication required. Returns hybrid-ranked results when `q` is provided, or a browseable list ordered by `sort` otherwise. Use this to find an existing API for a site before building your own with POST /dispatch.
- [Search marketplace endpoints](https://docs.parse.bot/api-reference/marketplace/search-marketplace-endpoints.md): Search across individual endpoints in the marketplace (not just APIs). No authentication required. Returns two groups: matching APIs and matching endpoints. Useful when you know the data you want but not which API provides it.
- [Subscribe to a marketplace API](https://docs.parse.bot/api-reference/marketplace/subscribe-to-a-marketplace-api.md): Create your own copy of the canonical, pinned to its current release and added to your account (My APIs). Returns a `scraper_id` you call at POST /scraper/{scraper_id}/{endpoint_name}. Pinned, so upstream changes don't alter your contract until you merge updates. Stays sync-eligible.
- [Authenticated APIs](https://docs.parse.bot/authenticated-apis.md): Call APIs that require login credentials
- [Authentication](https://docs.parse.bot/authentication.md): Get an API key and authenticate your requests
- [Dashboard guide](https://docs.parse.bot/dashboard.md): Build, test, and revise APIs in the Parse dashboard — then call them from your code
- [Errors & Troubleshooting](https://docs.parse.bot/errors.md): Decode every status code the execution API can return and act on it correctly
- [Code Examples](https://docs.parse.bot/examples.md): Call an API from your code — plus a separate example for building one programmatically
- [Introduction](https://docs.parse.bot/introduction.md): Call any website as a structured API
- [Marketplace](https://docs.parse.bot/marketplace.md): Search thousands of pre-built APIs before you build your own
- [MCP Server](https://docs.parse.bot/mcp.md): Connect AI agents to Parse via the Model Context Protocol
- [Quickstart](https://docs.parse.bot/quickstart.md): Create and call your first API in minutes
- [Python SDK](https://docs.parse.bot/sdk.md): Typed Python clients for your Parse APIs, generated by the parse CLI
- [API Updates](https://docs.parse.bot/updates.md): Keep your APIs current with upstream improvements

## OpenAPI Specs

- [openapi](https://docs.parse.bot/openapi.json)