Skip to content
Get started

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 ParametersExpand Collapse
requestID: string
Body ParametersJSONExpand Collapse
cancelled: optional boolean

Set to true to cancel/decline the request

fields: optional array of object { ref, value }

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

ref: optional string
value: optional string
ReturnsExpand Collapse
status: optional string

Submit Input Response

curl https://api.tabstack.ai/v1/automate/$REQUEST_ID/input \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $TABSTACK_API_KEY" \
    -d '{}'
{
  "status": "accepted"
}
Returns Examples
{
  "status": "accepted"
}