# ProjectAgentSourceSnapshot

Fields, types, and constraints for ProjectAgentSourceSnapshot.

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

Released API schema for `ProjectAgentSourceSnapshot`.

## Fields and constraints

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | Yes | Minimum length: 1. Maximum length: 512. |
| `initialWorkspaceId` | string | Yes | Minimum length: 1. Maximum length: 512. |
| `reference` | [ProjectAgentSourceReference](/docs/reference/schemas/project-agent-source-reference) | Yes |  |
| `provenance` | `"provider_confirmed"` · `"uploaded"` | Yes |  |
| `capturePolicy` | `"selected"` · `"full"` | Yes |  |
| `selectedPaths` | array of string | Yes |  |
| `manifestSha256` | string | Yes |  |
| `version` | integer | Yes |  |
| `state` | `"pending"` · `"ready"` · `"partial"` · `"failed"` · `"canceled"` · `"purged"` | Yes |  |
| `completeness` | `"pending"` · `"selected_only"` · `"complete"` · `"incomplete"` · `"purged"` | Yes |  |
| `filesProcessed` | integer | Yes |  |
| `bytesProcessed` | integer | Yes |  |
| `failureCode` | string or null | Yes |  |
| `retentionUntil` | string | Yes |  |
| `createdAt` | string | Yes |  |
| `collaboration` | object | No |  |

## Full schema

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

## Related reference

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