Create input request

createRunInputRequest(command: RunsCreateRunInputRequestCommand!, idempotencyKey: String): RunsInputRequest!

Arguments

ArgumentTypeRequiredDescription
commandRunsCreateRunInputRequestCommand!Yes
idempotencyKeyStringNoRetry key for this mutation (1-128 characters); overrides Idempotency-Key.

Input fields

command

RunsCreateRunInputRequestCommand

FieldTypeRequiredDescription
runIdID!YesRun that owns the input request. A fresh creation request without a recorded waiting tool call or tool_call_id, or with a duplicate open run/tool-call request, returns 409. An authorized retry of the identical request with the same idempotency key returns its stored result.
inputRunsCreateRunInputRequestCommandInput!Yes

Response

Returns RunsInputRequest!. Open the type for its fields and nested types.

FieldTypeDescription
inputRequestIdID!Unique input request ID.
projectIdID!Project inherited from the run.
runIdID!Run waiting for this input.
titleString!Question or decision shown to the responder.
fields[JSON!]!Fields the responder can fill in.
statusString!Current resolution state.
requestedResponderTypeString!Required responder role; the authenticated actor identifies who actually responded.
responseJSONSubmitted response, or null before submission or after cancellation or expiry.

All fields of RunsInputRequest.

Types marked with ! cannot be null. Lists use [Type] notation. The type index lists all published input and response types.

Example

graphql
mutation CreateRunInputRequest($command: RunsCreateRunInputRequestCommand!, $idempotencyKey: String) {
  createRunInputRequest(command: $command, idempotencyKey: $idempotencyKey) {
    projectId
    runId
    status
    createdAt
    conversationId
  }
}
json
{
  "command": {
    "runId": "11111111-1111-4111-8111-111111111111",
    "input": {
      "title": "Approve the result",
      "fields": [
        {
          "name": "approved",
          "type": "confirm"
        }
      ]
    }
  }
}