# ProjectAgentProgressItem

Fields, types, and constraints for ProjectAgentProgressItem.

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

Released API schema for `ProjectAgentProgressItem`.

## Fields and constraints

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | Yes | Minimum length: 1. Maximum length: 512. |
| `title` | string | Yes | Maximum length: 200. |
| `href` | string | Yes | Maximum length: 4096. |
| `sessionId` | string | Yes | Minimum length: 1. Maximum length: 512. |
| `target` | [ProjectAgentReviewAcceptanceTarget](/docs/reference/schemas/project-agent-review-acceptance-target) | Yes |  |
| `recordId` | string | No | Minimum length: 1. Maximum length: 512. |
| `recordVersion` | integer | No |  |
| `trackerId` | string | No | Minimum length: 1. Maximum length: 512. |
| `relationVersion` | integer | No |  |
| `execution` | `"reported_complete"` · `"in_progress"` · `"not_configured"` | Yes |  |
| `artifact` | `"available"` · `"source_unavailable"` | Yes |  |
| `review` | `"ready"` · `"requested_changes"` · `"open_concerns"` · `"not_ready"` | Yes |  |
| `acceptance` | `"not_required"` · `"not_requested"` · `"pending"` · `"accepted"` · `"stale"` · `"requested_changes"` · `"rejected"` · `"expired"` · `"revoked"` · `"unsatisfiable"` · `"unknown"` | Yes |  |
| `verification` | `"independently_verified"` · `"reported"` · `"failed"` · `"unknown"` | Yes |  |
| `openConcerns` | integer | Yes |  |
| `blockers` | array of string | Yes |  |
| `state` | `"working"` · `"ready_for_review"` · `"requested_changes"` · `"accepted"` · `"stale"` · `"blocked"` | Yes |  |
| `decision` | object or null | Yes |  |
| `nextAction` | object | Yes |  |

## Full schema

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

## Related reference

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