---
title: "Send future-facing guidance to the agent that created an Interaction."
method: POST
path: "/api/v1/interactions/{interactionId}/guidance"
tags: ["Interactions"]
---

# Send future-facing guidance to the agent that created an Interaction.

`POST /api/v1/interactions/{interactionId}/guidance`

## Request

- Base URL: `https://commentary.dev`
- URL: `https://commentary.dev/api/v1/interactions/{interactionId}/guidance`
- Auth: API key in cookie `commentary_session`

Same-origin human action. Delivery marks the card read but never changes the current request, lifecycle, bucket, rank, conversation, or Decisions.

## Path parameters

- `interactionId` string, required

## Headers

- `If-Match` string, required
- `Idempotency-Key` string, required

## Request body

- object
  - `revisionId` string, required
  - `scope` 'similar_items' | 'same_source' | 'agent_behavior' | 'general', required
  - `body` string, required

## Response `200`

Successful response.

- object

## Other responses

- `201`: Successful response.
- `400`: The request was invalid.
- `401`: Authentication is required.
- `403`: The token or session does not have permission for this resource.
- `404`: The resource was not found.
- `409`: The Interaction revision or idempotency request conflicts.
- `410`: Interaction content was purged.
- `412`: If-Match is stale or malformed.
- `428`: If-Match is required.
- `429`: The request was rate limited.

---

[API](https://skmtc.dev/commentary/apis/commentary-public-api.md) · [All operations](https://skmtc.dev/commentary/apis/commentary-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/commentary/apis/commentary-public-api/revisions/7aaafc198c52?raw)