Create run - Veryfront

createRun(input: CreateRunInput!): CreateRunResult!

Requires editor access to the owner, and project.runs.write for a project owner.

Arguments

Argument	Type	Required
`input`	`CreateRunInput!`	Yes

Input fields

input

CreateRunInput

Field	Type	Required	Description
`kind`	`String!`	Yes	agent, workflow, task or eval.
`owner`	`RunOwnerInput!`	Yes
`publicId`	`String`	No	Caller-chosen run id. Repeating a publicId returns the existing run with duplicate true.
`parentRunId`	`String`	No
`trigger`	`RunTriggerInput`	No
`composingUserId`	`ID`	No	Conversation-owned agent runs: the account that composed the run.
`conversationMode`	`String`	No	Project-owned agent runs: none (default), create_new or existing.
`conversationId`	`ID`	No	Project-owned agent runs with conversationMode existing.
`request`	`JSON!`	Yes	The kind-specific request, as in the REST body: workflow {name, workflow_id, target, input, start_mode, runtime_target_}; task {target, name, batch_id, input, config, timeout_seconds, backoff_limit, runtime_target_}; eval {name, target, input, config, start_mode, runtime_target_*}; agent {mode: “agent”, name and the agent request fields}. name is the run’s title.

Response

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

Field	Type	Description
`accepted`	`Boolean!`
`duplicate`	`Boolean`	True when the publicId already named this run; null otherwise (REST omits the key).
`run`	`Run!`
`conversationId`	`ID`	The conversation a project-owned agent run runs in, when it has one.
`messageId`	`ID`	The message a conversation agent run answers, when it has one.

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

Example

mutation CreateRun($input: CreateRunInput!) {
  createRun(input: $input) {
    accepted
    conversationId
    duplicate
    messageId
    run {
      id
      projectId
      runId
      status
      createdAt
    }
  }
}

{
  "input": {
    "kind": "example",
    "owner": {
      "kind": "example",
      "id": "00000000-0000-4000-8000-000000000001"
    },
    "request": {}
  }
}