Skip to main content

Legacy Browser Tasks API

Legacy browser-use agent and task endpoints for submitting browser automation jobs, polling status, and retrieving results.

📄️Legacy Agent Task - Create

Create a resource in the API key's owner scope. Read-only fields in the representation cannot be set by the client. Requires `agents:operate`. When API_ADMISSION_ENABLED is true, omit wait even without Idempotency-Key; queued-input capacity is shared across stable principal and owner. Optional protected retries require API_EXTENDED_RETRIES_ENABLED for new admissions; retained retries survive disabling admission. Original outcomes expire after 24 hours by default; current authority is rechecked. Task creation requires wait to be omitted. Secret rotation retries conflict if superseded.

📄️Legacy Agent Task - Update

Update supplied writable task inputs while pending and unclaimed. A supplied secrets map replaces all task credentials; {} clears them, omission preserves them, and null is invalid. Secret columns and other inputs commit atomically. A winning worker claim or cancellation rejects input edits with 400; deleted or retention-purged tasks return 404. Webhook-only edits remain available on retained running/terminal tasks. Responses never return credentials or key lists. Success acknowledges stored input, not execution or authentication. These updates have no credential readback, conditional revision or idempotency guarantee. Requires `agents:operate`.

📄️Legacy Agent Task - Patch

Update supplied writable task inputs while pending and unclaimed. A supplied secrets map replaces all task credentials; {} clears them, omission preserves them, and null is invalid. Secret columns and other inputs commit atomically. A winning worker claim or cancellation rejects input edits with 400; deleted or retention-purged tasks return 404. Webhook-only edits remain available on retained running/terminal tasks. Responses never return credentials or key lists. Success acknowledges stored input, not execution or authentication. These updates have no credential readback, conditional revision or idempotency guarantee. Requires `agents:operate`.

📄️Standalone Legacy Task - Create

Create a resource in the API key's owner scope. Read-only fields in the representation cannot be set by the client. Requires `agents:operate`. When API_ADMISSION_ENABLED is true, omit wait even without Idempotency-Key; queued-input capacity is shared across stable principal and owner. Optional protected retries require API_EXTENDED_RETRIES_ENABLED for new admissions; retained retries survive disabling admission. Original outcomes expire after 24 hours by default; current authority is rechecked. Task creation requires wait to be omitted. Secret rotation retries conflict if superseded.

📄️Standalone Legacy Task - Update

Update supplied writable task inputs while pending and unclaimed. A supplied secrets map replaces all task credentials; {} clears them, omission preserves them, and null is invalid. Secret columns and other inputs commit atomically. A winning worker claim or cancellation rejects input edits with 400; deleted or retention-purged tasks return 404. Webhook-only edits remain available on retained running/terminal tasks. Responses never return credentials or key lists. Success acknowledges stored input, not execution or authentication. These updates have no credential readback, conditional revision or idempotency guarantee. Requires `agents:operate`.

📄️Standalone Legacy Task - Patch

Update supplied writable task inputs while pending and unclaimed. A supplied secrets map replaces all task credentials; {} clears them, omission preserves them, and null is invalid. Secret columns and other inputs commit atomically. A winning worker claim or cancellation rejects input edits with 400; deleted or retention-purged tasks return 404. Webhook-only edits remain available on retained running/terminal tasks. Responses never return credentials or key lists. Success acknowledges stored input, not execution or authentication. These updates have no credential readback, conditional revision or idempotency guarantee. Requires `agents:operate`.