Respond to input request

createInputResponse(command: RunsCreateInputResponseCommand!, idempotencyKey: String): RunsInputRequest!

Arguments

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

Input fields

command

RunsCreateInputResponseCommand

FieldTypeRequiredDescription
inputRequestIdID!YesInput request to answer. Every caller must match the requested responder role. Unbound callers need editor access to the run owner and project.runs.write. A bound runtime credential instead must match the exact run and needs conversations:write, viewer access to the run owner, and project.runs.read. A linked conversation also requires editor access. A fresh response to an already-resolved request returns 409 (submission, cancellation and expiry compete atomically). An authorized retry of the identical request with the same idempotency key returns its stored result.
inputRunsCreateInputResponseCommandInput!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 CreateInputResponse($command: RunsCreateInputResponseCommand!, $idempotencyKey: String) {
  createInputResponse(command: $command, idempotencyKey: $idempotencyKey) {
    projectId
    runId
    status
    createdAt
    conversationId
  }
}
json
{
  "command": {
    "inputRequestId": "00000000-0000-4000-8000-000000000001",
    "input": {
      "values": {
        "approved": true
      }
    }
  }
}