Automate

Submit Input Response

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, already-answered, or unknown requests return 410 Gone
  • A requestID belonging to another organization is not visible to you and returns 410 Gone
  • Successful submissions return 202 Accepted (fire-and-forget from caller's perspective)
post/automate/{requestID}/input

Request

  • Base URL: https://api.tabstack.ai/v1
  • URL: https://api.tabstack.ai/v1/automate/{requestID}/input
  • Auth: HTTP bearer

Path parameters

requestIDstring required

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

Request body

cancelledboolean

Set to true to cancel/decline the request

Example request

{
  "fields": [
    {
      "ref": "E42",
      "value": "user@example.com"
    }
  ]
}

Response

Input response accepted and forwarded to the automation task

statusstring

Example response

{
  "status": "accepted"
}

Changes

No recorded changes to this operation across all 1 revision of this API.