---
title: "Submit Input Response"
method: POST
path: "/automate/{requestID}/input"
tags: ["Automate"]
---

# Submit Input Response

`POST /automate/{requestID}/input`

Submit a response to an interactive form data request from an in-progress automation task. When the AI agent encounters a form requiring user data, it emits an `interactive:form_data:request` or `interactive:form_data:error` SSE event containing a `requestId`. Use this endpoint to provide the requested data or cancel the request.

**Lifecycle:**
- Input requests expire after 2 minutes by default
- Expired or already-answered requests return `410 Gone`
- Successful submissions return `202 Accepted` (fire-and-forget from caller's perspective)

## Path parameters

- `requestID` string, required

## Request body

- V1AutomateInputRequest
  - `cancelled` boolean — Set to true to cancel/decline the request
  - `fields` V1AutomateInputFieldValue[] — Field values as array of {ref, value} pairs (required when not cancelled)
    - `ref` string
    - `value` string

## Response `202`

Input response accepted and forwarded to the automation task

- V1AutomateInputResponse
  - `status` string

## Other responses

- `400` — Bad request - Invalid JSON
- `401` — Unauthorized - Invalid or missing Bearer token
- `402` — Payment Required - organization is out of credits
- `410` — Gone - Input request has expired or already been answered
- `429` — Too Many Requests - rate limit exceeded
- `500` — Internal server error
- `503` — Service unavailable - Input service not configured

## Changes

- **2026-08-10** `f3f7ba7d83e4` — 2 info
  - added the non-success response with the status `402`
  - added the non-success response with the status `429`
- **2026-04-10** `ab135cad4c10` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/mozilla-ocho/apis/tabs-api/changes/automate/:requestID/input/post.md)

---

[API](https://skmtc.dev/mozilla-ocho/apis/tabs-api.md) · [All operations](https://skmtc.dev/mozilla-ocho/apis/tabs-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/mozilla-ocho/tabs-api/revisions/f3f7ba7d83e4/schema)