# RunAgentInput (/api/reference/inputs/run-agent-input)

Which agent to run, on whom.

```graphql
input RunAgentInput {
  agentId: ID!
  candidateIds: [ID!]!
  jobId: ID
}
```

### Fields [#fields]

#### [`RunAgentInput.agentId`](#agent-id) · [`ID!`](/api/reference/scalars/id) `non-null` `scalar` [#agent-id]
The agent to run. It must be switched on.

#### [`RunAgentInput.candidateIds`](#candidate-ids) · [`[ID!]!`](/api/reference/scalars/id) `non-null` `scalar` [#candidate-ids]
The candidates to run it on, one run each, in this order. They must be candidates released to the workspace. From 1 to 10.

#### [`RunAgentInput.jobId`](#job-id) · [`ID`](/api/reference/scalars/id) `scalar` [#job-id]
The job to judge the candidates for. Left out, the agent works without a brief.

### Member Of [#member-of]

[`runAgent`](/api/reference/mutations/run-agent)  `mutation`