Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-141610169.0 KB

Creates a new AI task (act) within a session that can interact with tools and perform specific actions.

put/workflow-definitions/{workflowDefinitionName}/workflow-runs/{workflowRunId}/sessions/{sessionId}/acts

Path parameters

workflowDefinitionNamestring required

The name of the workflow definition containing the session.

workflowRunIdstring required

The unique identifier of the workflow run containing the session.

sessionIdstring required

The unique identifier of the session to create the act in.

Request body

taskstring password required

The task description that defines what the act should accomplish.

clientTokenstring

A unique, case-sensitive identifier that you provide to ensure the idempotency of the request.

Response

Success

actIdstring required

The unique identifier for the created act.

status'RUNNING' | 'PENDING_CLIENT_ACTION' | 'PENDING_HUMAN_ACTION' | 'SUCCEEDED' | 'FAILED' | 'TIMED_OUT' required

The initial status of the act after creation.

All 16 operations