# CodePipelineProcessStartRequest

Starts a run of a code pipeline: its inputs, the repositories to work on, and any changes to the pipeline for this run.

**Kind:** an object, used in requests and responses. In a request it is called `CodePipelineProcessStartRequestInput`.

## In a request

| Field | Type | Required | Description |
|---|---|---|---|
| `launchIntentId` | `uuid \| null` |  | Your own id for this start, to make retries safe: starting again with the same id returns the run it already created instead of starting a second one. Null: every start creates a new run. |
| `inputs` | [`NameValuePair`](https://docs.maitento.com/reference/types/name-value-pair.md)`[]` | yes | The run's input values, by input name. Send an empty array when there are none. Constraints: required (empty or whitespace-only strings are rejected). |
| `agentOverrides` | [`CodePipelineProcessAgentOverrideInput`](https://docs.maitento.com/reference/types/code-pipeline-process-agent-override.md#in-a-request)`[] \| null` |  | Different engines or models for some of the agents, for this run. |
| `additionalAgents` | [`CodePipelineAgentInput`](https://docs.maitento.com/reference/types/code-pipeline-agent.md#in-a-request)`[] \| null` |  | Agents for this run only, alongside the pipeline's own. Steps, overrides and the review panel can name them. Each needs a `role` and a name of lower-case letters, digits and hyphens (up to 63 characters, not starting with a hyphen) that no other agent has. At most 16. |
| `reviewPanel` | [`CodePipelineReviewPanelInput`](https://docs.maitento.com/reference/types/code-pipeline-review-panel.md#in-a-request)`\| null` |  | The run's review panel. Each reviewer's step must be in the panel's phase (from the pipeline, or added with `additionalSteps`) with the same agent and output variable, and each reviewer's output variable must be unique. |
| `maxParallelSteps` | `integer \| null` |  | For this run, how many of a phase's steps may run at once, in place of the pipeline's `maxParallelSteps`. Null: the pipeline's value. Between 1 and 16. |
| `additionalSteps` | [`CodePipelineProcessAdditionalStepsInput`](https://docs.maitento.com/reference/types/code-pipeline-process-additional-steps.md#in-a-request)`[] \| null` |  | Steps to add to the pipeline's phases for this run only. |
| `credentials` | [`CodePipelineProcessCredentialsInput`](https://docs.maitento.com/reference/types/code-pipeline-process-credentials.md)`[]` |  | Credentials for the engines, tried before your tenant's model keys. Optional: without them, the engines use your tenant's model keys, then (unless your tenant forbids it) Maitento's own. Your own API keys must not be empty. |
| `credentialStack` | `string \| null` |  | The credential stack the run's engines use, by id or name: its API keys and coding-agent sign-ins, in the stack's order, and never Maitento's own keys. An engine the stack can't serve stops the run before it starts. Leave it out to use the pipeline's own stack, then the namespace's default, then your tenant's. Can't be combined with `credentials`. |
| `repos` | [`CodePipelineProcessRepoInput`](https://docs.maitento.com/reference/types/code-pipeline-process-repo.md)`[]` | yes | The git repositories to work on, with credentials that can push. Send an empty array to run without one. Constraints: required (empty or whitespace-only strings are rejected). |
| `vfsMounts` | [`CodePipelineProcessVfsMountInput`](https://docs.maitento.com/reference/types/code-pipeline-process-vfs-mount.md#in-a-request)`[] \| null` |  | File systems to mount for the run's agents. |
| `systemPromptOverride` | `string \| null` |  | An extra system prompt for this run, applied on top of the pipeline's and agents' prompts. |
| `inputFileIds` | `uuid[] \| null` |  | Uploaded files to copy into the agents' `files/` folder before the run starts. They must belong to your tenant. |
| `outputFilesPartitionId` | `uuid \| null` |  | A knowledge base (partition) to upload the files the agents write to `output_files/` to, as the run goes. It must belong to your tenant. Null: output files aren't uploaded. |
| `autoRebase` | `boolean` |  | Whether to rebase each work branch onto its source branch when they have diverged, with an agent resolving any conflicts. Default `true`. Skipped for a repository whose work branch is its source branch. |
| `rebaseAgent` | `string \| null` |  | The agent that resolves rebase conflicts. Null: the first available of the run's agents by engine, in this order: Claude, Glm, Codex, Gemini, Qwen, DeepSeek, Kimi. |
| `maxCheckLoops` | `integer \| null` |  | For this run, the most rounds of a step's `runChallengeLoop` check, in place of the pipeline's `maxCheckLoops`. Null: the pipeline's value. Capped at 8. |
| `maxFixIterations` | `integer \| null` |  | For this run, the most review-and-fix rounds, in place of the pipeline's `maxFixIterations`. Null: the pipeline's value. Capped at 5. |
| `allowWebTools` | `boolean \| null` |  | For this run, whether every agent gets Maitento's web tools. Null: each agent's and the pipeline's own `allowWebTools`. |
| `webDownloadPartitionId` | `uuid \| null` |  | The temporary knowledge base (partition) the run's web fetches are kept in. Null: the pipeline's namespace default, then your tenant's. A run whose agents may use the web tools is refused when none of the three is set. |
| `stepMax` | `timespan \| null` |  | For this run, the longest every step may run, in place of each step's own `durationAutoTermination`. |
| `stepActivity` | `timespan \| null` |  | For this run, how long every step may go without activity, in place of each step's own `durationActivityTimeout`. |
| `phaseMax` | `timespan \| null` |  | For this run, each phase's `durationAutoTermination`: the limit for steps that set none of their own. |
| `phaseActivity` | `timespan \| null` |  | For this run, each phase's `durationActivityTimeout`: the limit for steps that set none of their own. |
| `processMax` | `timespan \| null` |  | For this run, the pipeline's `durationAutoTermination`: the limit for steps whose step and phase set none. |
| `processActivity` | `timespan \| null` |  | For this run, the pipeline's `durationActivityTimeout`: the limit for steps whose step and phase set none. |
| `hook` | `timespan \| null` |  | For this run, the longest one hook may run, in place of the pipeline's `hookDurationLimit`. |

```json
{
  "launchIntentId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
  "inputs": [
    {
      "name": "...",
      "value": "..."
    }
  ],
  "agentOverrides": [
    {
      "agentName": "...",
      "engine": "Claude",
      "model": "..."
    }
  ],
  "additionalAgents": [
    {
      "name": "...",
      "defaultEngine": "Claude",
      "role": "Architect",
      "tags": [],
      "defaultModel": "...",
      "systemPrompts": [],
      "enginePrompts": [],
      "systemPromptMode": "Additional",
      "externalOperationsMcp": [],
      "externalOperationsOpenApi": [],
      "allowWebTools": false
    }
  ],
  "reviewPanel": {
    "phaseName": "...",
    "recheckPolicy": "AllMembers",
    "members": [
      {}
    ]
  },
  "maxParallelSteps": 0,
  "additionalSteps": [
    {
      "phaseName": "...",
      "steps": []
    }
  ],
  "credentials": [
    {
      "type": "apiKey"
    }
  ],
  "credentialStack": "...",
  "repos": [
    {
      "type": "http"
    }
  ],
  "vfsMounts": [
    {
      "name": "...",
      "vfsId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
      "mode": "ReadOnly",
      "context": "..."
    }
  ],
  "systemPromptOverride": "...",
  "inputFileIds": [
    "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f"
  ],
  "outputFilesPartitionId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
  "autoRebase": false,
  "rebaseAgent": "...",
  "maxCheckLoops": 0,
  "maxFixIterations": 0,
  "allowWebTools": false,
  "webDownloadPartitionId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
  "stepMax": "00:05:00",
  "stepActivity": "00:05:00",
  "phaseMax": "00:05:00",
  "phaseActivity": "00:05:00",
  "processMax": "00:05:00",
  "processActivity": "00:05:00",
  "hook": "00:05:00"
}
```

## In a response

Every field is present in a response; empty ones are `null`.

| Field | Type | Description |
|---|---|---|
| `launchIntentId` | `uuid \| null` | Your own id for this start, to make retries safe: starting again with the same id returns the run it already created instead of starting a second one. Null: every start creates a new run. |
| `inputs` | [`NameValuePair`](https://docs.maitento.com/reference/types/name-value-pair.md)`[]` | The run's input values, by input name. Send an empty array when there are none. Constraints: required (empty or whitespace-only strings are rejected). |
| `agentOverrides` | [`CodePipelineProcessAgentOverride`](https://docs.maitento.com/reference/types/code-pipeline-process-agent-override.md)`[] \| null` | Different engines or models for some of the agents, for this run. |
| `additionalAgents` | [`CodePipelineAgent`](https://docs.maitento.com/reference/types/code-pipeline-agent.md)`[] \| null` | Agents for this run only, alongside the pipeline's own. Steps, overrides and the review panel can name them. Each needs a `role` and a name of lower-case letters, digits and hyphens (up to 63 characters, not starting with a hyphen) that no other agent has. At most 16. |
| `reviewPanel` | [`CodePipelineReviewPanel`](https://docs.maitento.com/reference/types/code-pipeline-review-panel.md)`\| null` | The run's review panel. Each reviewer's step must be in the panel's phase (from the pipeline, or added with `additionalSteps`) with the same agent and output variable, and each reviewer's output variable must be unique. |
| `maxParallelSteps` | `integer \| null` | For this run, how many of a phase's steps may run at once, in place of the pipeline's `maxParallelSteps`. Null: the pipeline's value. Between 1 and 16. |
| `additionalSteps` | [`CodePipelineProcessAdditionalSteps`](https://docs.maitento.com/reference/types/code-pipeline-process-additional-steps.md)`[] \| null` | Steps to add to the pipeline's phases for this run only. |
| `credentials` | [`CodePipelineProcessCredentials`](https://docs.maitento.com/reference/types/code-pipeline-process-credentials.md)`[]` | Credentials for the engines, tried before your tenant's model keys. Optional: without them, the engines use your tenant's model keys, then (unless your tenant forbids it) Maitento's own. Your own API keys must not be empty. |
| `credentialStack` | `string \| null` | The credential stack the run's engines use, by id or name: its API keys and coding-agent sign-ins, in the stack's order, and never Maitento's own keys. An engine the stack can't serve stops the run before it starts. Leave it out to use the pipeline's own stack, then the namespace's default, then your tenant's. Can't be combined with `credentials`. |
| `repos` | [`CodePipelineProcessRepo`](https://docs.maitento.com/reference/types/code-pipeline-process-repo.md)`[]` | The git repositories to work on, with credentials that can push. Send an empty array to run without one. Constraints: required (empty or whitespace-only strings are rejected). |
| `vfsMounts` | [`CodePipelineProcessVfsMount`](https://docs.maitento.com/reference/types/code-pipeline-process-vfs-mount.md)`[] \| null` | File systems to mount for the run's agents. |
| `systemPromptOverride` | `string \| null` | An extra system prompt for this run, applied on top of the pipeline's and agents' prompts. |
| `inputFileIds` | `uuid[] \| null` | Uploaded files to copy into the agents' `files/` folder before the run starts. They must belong to your tenant. |
| `outputFilesPartitionId` | `uuid \| null` | A knowledge base (partition) to upload the files the agents write to `output_files/` to, as the run goes. It must belong to your tenant. Null: output files aren't uploaded. |
| `autoRebase` | `boolean` | Whether to rebase each work branch onto its source branch when they have diverged, with an agent resolving any conflicts. Default `true`. Skipped for a repository whose work branch is its source branch. |
| `rebaseAgent` | `string \| null` | The agent that resolves rebase conflicts. Null: the first available of the run's agents by engine, in this order: Claude, Glm, Codex, Gemini, Qwen, DeepSeek, Kimi. |
| `maxCheckLoops` | `integer \| null` | For this run, the most rounds of a step's `runChallengeLoop` check, in place of the pipeline's `maxCheckLoops`. Null: the pipeline's value. Capped at 8. |
| `maxFixIterations` | `integer \| null` | For this run, the most review-and-fix rounds, in place of the pipeline's `maxFixIterations`. Null: the pipeline's value. Capped at 5. |
| `allowWebTools` | `boolean \| null` | For this run, whether every agent gets Maitento's web tools. Null: each agent's and the pipeline's own `allowWebTools`. |
| `webDownloadPartitionId` | `uuid \| null` | The temporary knowledge base (partition) the run's web fetches are kept in. Null: the pipeline's namespace default, then your tenant's. A run whose agents may use the web tools is refused when none of the three is set. |
| `stepMax` | `timespan \| null` | For this run, the longest every step may run, in place of each step's own `durationAutoTermination`. |
| `stepActivity` | `timespan \| null` | For this run, how long every step may go without activity, in place of each step's own `durationActivityTimeout`. |
| `phaseMax` | `timespan \| null` | For this run, each phase's `durationAutoTermination`: the limit for steps that set none of their own. |
| `phaseActivity` | `timespan \| null` | For this run, each phase's `durationActivityTimeout`: the limit for steps that set none of their own. |
| `processMax` | `timespan \| null` | For this run, the pipeline's `durationAutoTermination`: the limit for steps whose step and phase set none. |
| `processActivity` | `timespan \| null` | For this run, the pipeline's `durationActivityTimeout`: the limit for steps whose step and phase set none. |
| `hook` | `timespan \| null` | For this run, the longest one hook may run, in place of the pipeline's `hookDurationLimit`. |

```json
{
  "launchIntentId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
  "inputs": [
    {
      "name": "...",
      "value": "..."
    }
  ],
  "agentOverrides": [
    {
      "agentName": "...",
      "engine": "Claude",
      "model": "..."
    }
  ],
  "additionalAgents": [
    {
      "name": "...",
      "defaultEngine": "Claude",
      "role": "Architect",
      "tags": [],
      "defaultModel": "...",
      "systemPrompts": [],
      "enginePrompts": [],
      "systemPromptMode": "Additional",
      "externalOperationsMcp": [],
      "externalOperationsOpenApi": [],
      "allowWebTools": false
    }
  ],
  "reviewPanel": {
    "phaseName": "...",
    "recheckPolicy": "AllMembers",
    "members": [
      {}
    ]
  },
  "maxParallelSteps": 0,
  "additionalSteps": [
    {
      "phaseName": "...",
      "steps": []
    }
  ],
  "credentials": [
    {
      "type": "apiKey"
    }
  ],
  "credentialStack": "...",
  "repos": [
    {
      "type": "http"
    }
  ],
  "vfsMounts": [
    {
      "name": "...",
      "vfsId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
      "mode": "ReadOnly",
      "context": "..."
    }
  ],
  "systemPromptOverride": "...",
  "inputFileIds": [
    "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f"
  ],
  "outputFilesPartitionId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
  "autoRebase": false,
  "rebaseAgent": "...",
  "maxCheckLoops": 0,
  "maxFixIterations": 0,
  "allowWebTools": false,
  "webDownloadPartitionId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
  "stepMax": "00:05:00",
  "stepActivity": "00:05:00",
  "phaseMax": "00:05:00",
  "phaseActivity": "00:05:00",
  "processMax": "00:05:00",
  "processActivity": "00:05:00",
  "hook": "00:05:00"
}
```

## Where it's used

- [`pipelines.start`](https://docs.maitento.com/reference/api/pipelines.md) (`PUT /code-pipelines/processes/by-id/{id}/start`)
- [`pipelines.start`](https://docs.maitento.com/reference/api/pipelines.md) (`PUT /namespaces/{namespaceName}/code-pipelines/by-name/{name}/start`)
- Inside [`CodePipelineProcessStartConfig`](https://docs.maitento.com/reference/types/code-pipeline-process-start-config.md)