# ProjectAgentError

Fields, types, and constraints for ProjectAgentError.

Canonical: https://commentary.dev/docs/reference/schemas/project-agent-error

Released API schema for `ProjectAgentError`.

## Fields and constraints

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `version` | `"1"` | Yes |  |
| `code` | `"authentication_required"` · `"insufficient_scope"` · `"not_found"` · `"validation_failed"` · `"capability_unsupported"` · `"contract_version_unsupported"` · `"precondition_required"` · `"precondition_failed"` · `"version_conflict"` · `"idempotency_key_required"` · `"idempotency_key_reused"` · `"source_access_revoked"` · `"source_unavailable"` · `"unsupported_provider_write"` · `"source_conflict"` · `"upload_expired"` · `"checksum_mismatch"` · `"schema_incompatible"` · `"limit_reached"` · `"rate_limited"` · `"event_cursor_resync_required"` · `"bridge_disconnected"` · `"verification_unavailable"` · `"internal_error"` | Yes |  |
| `message` | string | Yes | Maximum length: 4096. |
| `correlationId` | string | Yes |  |
| `details` | array of object | No |  |
| `retryable` | boolean | No |  |

## Full schema

[Download this schema](/docs/reference/schemas/project-agent-error.json) or use the [complete OpenAPI document](/docs/reference/openapi.json) to resolve all references.

## Related reference

[Browse API endpoints](/docs/reference/api-operations).
