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)

Authorization

BearerAuth
AuthorizationBearer <token>

Bearer token for API authentication

In: header

Path Parameters

requestID*string

The request ID from the interactive:form_data:request SSE event

Request Body

application/json

Input response with field values or cancellation

cancelled?boolean

Set to true to cancel/decline the request

fields?array<>

Field values as array of {ref, value} pairs (required when not cancelled)

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/automate/string/input" \  -H "Content-Type: application/json" \  -d '{}'
{  "status": "accepted"}