# CodePipelinePhaseExecution

How one phase of a code pipeline run is going, with its steps.

**Kind:** an object, used in responses.

## Fields

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

| Field | Type | Description |
|---|---|---|
| `phaseName` | `string` | The phase's name. |
| `status` | [`CodePipelinePhaseExecutionStatus`](https://docs.maitento.com/reference/types/code-pipeline-phase-execution-status.md) | Where the phase is. |
| `dateStart` | `datetime \| null` | When the phase started, in UTC. Null until it starts. |
| `dateEnd` | `datetime \| null` | When the phase ended, in UTC. Null until it ends. |
| `steps` | [`CodePipelineStepExecution`](https://docs.maitento.com/reference/types/code-pipeline-step-execution.md)`[]` | The phase's steps, from the definition plus any added for the run or by hooks. |
| `failureDetails` | `string \| null` | Why the phase failed. Null unless it did. |
| `hookPreOutput` | `string \| null` | What the phase's `preHook` returned, as JSON. Null when it has none or returned nothing. |
| `hookPostOutput` | `string \| null` | What the phase's `postHook` returned, as JSON. Null when it has none or returned nothing. |

## Example

```json
{
  "phaseName": "...",
  "status": "NotStarted",
  "dateStart": "2026-10-26T12:00:00.0000000Z",
  "dateEnd": "2026-10-26T12:00:00.0000000Z",
  "steps": [
    {
      "id": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
      "stepName": "...",
      "agentName": "...",
      "status": "NotStarted",
      "output": "...",
      "finalResult": "...",
      "outputStructured": {},
      "failureDetails": "...",
      "dateStart": "2026-10-26T12:00:00.0000000Z",
      "dateEnd": "2026-10-26T12:00:00.0000000Z",
      "didCommit": false,
      "tokenUsage": [],
      "humanInteractionRequests": [],
      "engineSessionId": "...",
      "outputs": [],
      "challengeLoopTurns": [],
      "toolUseRefs": [],
      "contextEntryRefs": []
    }
  ],
  "failureDetails": "...",
  "hookPreOutput": "...",
  "hookPostOutput": "..."
}
```

## Where it's used

- Inside [`CodePipelineProcess`](https://docs.maitento.com/reference/types/code-pipeline-process.md)