# InteractionGuidance

Immutable future-facing human guidance plus an optional content-free agent acknowledgment receipt.

Canonical: https://commentary.dev/docs/reference/schemas/interaction-guidance

Immutable future-facing human guidance plus an optional content-free agent acknowledgment receipt.

## Fields and constraints

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | Yes |  |
| `interactionId` | string | Yes |  |
| `revisionId` | string | Yes |  |
| `scope` | `"similar_items"` · `"same_source"` · `"agent_behavior"` · `"general"` | Yes |  |
| `body` | string or null | Yes | Maximum length: 16384. |
| `deliveredAt` | string | Yes | Format: date-time. |
| `contentPurgedAt` | string or null | No | Format: date-time. |
| `status` | `"delivered"` · `"acknowledged"` | Yes |  |
| `acknowledgment` | null or object | Yes |  |

## Full schema

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

## Related reference

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