# CodePipelineCredentialFailure

A failure of one of your own credentials during a run. The engine then tries its next credential, if it has one. Use it to spot a key that needs fixing or replacing.

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

## Fields

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

| Field | Type | Description |
|---|---|---|
| `credentialId` | `string` | The `credentialId` of the credential that failed. |
| `reason` | `string` | Why it failed: `"Auth"` (the key or sign-in was rejected), `"RateLimit"`, `"Quota"` (its usage limit is used up), `"EndpointModelNotFound"` (its endpoint doesn't serve the model asked for) or `"Endpoint"` (its endpoint answered "not found", usually a mistyped base URL). The last two say nothing about whether the key itself is good. |
| `detail` | `string \| null` | A short description of the failure, from the coding tool's output. |
| `dateUtc` | `datetime` | When it failed, in UTC. |
| `retryAfterSeconds` | `integer \| null` | For a `"RateLimit"` failure, how many seconds the provider said to wait before trying again. Null when it didn't say, and for every other reason. |

## Example

```json
{
  "credentialId": "...",
  "reason": "...",
  "detail": "...",
  "dateUtc": "2026-10-26T12:00:00.0000000Z",
  "retryAfterSeconds": 0
}
```

## Where it's used

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