Skip to content

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.

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

FieldTypeDescription
credentialIdstringThe credentialId of the credential that failed.
reasonstringWhy 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.
detailstring | nullA short description of the failure, from the coding tool’s output.
dateUtcdatetimeWhen it failed, in UTC.
retryAfterSecondsinteger | nullFor 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.
{
"credentialId": "...",
"reason": "...",
"detail": "...",
"dateUtc": "2026-10-26T12:00:00.0000000Z",
"retryAfterSeconds": 0
}