Task Generation API

Create asynchronous task generation jobs for AI-generated scrapers or workflow-based tasks.

The request body always includes a mode. Start with agent for URL-driven scraper generation. Use workflow when you already have a workflow_spec and a set of source tasks.

Request Body

Agent Mode

In agent mode, url is required. description is optional and should describe what the scraper needs to extract. name is also optional in agent mode and is generated automatically. If you omit description, Browsable will inspect the page and auto-generate an extraction description for you.

Workflow Mode

You can optionally send an Idempotency-Key header to make retries safe. The key is optional and does not change the request shape.

Response

Creation returns 202 Accepted while the generation job is pending. Poll the returned status_url until the job reaches completed or failed. The create response is intentionally lean; the status endpoint returns the fuller lifecycle record, including the generated name/description once the agent has written them back.

Status Endpoint

curl -X GET "https://api.browsable.app/v1/task-generations/tg_abc123" \
  -H "Authorization: Bearer YOUR_API_KEY"

The status endpoint returns a public-safe summary of the generated scraper and a generated_task reference you can call immediately. Browsable does not return the generated code, bundle IDs, execution refs, or internal path templates from this endpoint.