course_reviews_apply

# course_reviews_apply

Writes, edits, publishes or deletes class reviews in the Course app (pApp C00007). Shows a preview first; the change runs only after confirmation. Called without confirmToken it previews and returns a confirmToken; repeating the same input with it executes once.

## Inputs

| Field | Required here | Contract |
| --- | --- | --- |
| `action` | Yes | one of: `create`, `edit`, `publish`, `delete` (by `kind`) |
| `action.content` | Yes | When `action.kind` is `create`: string |
| `action.score` | Yes | When `action.kind` is `create`: integer; minimum 1; maximum 5 or null |
| `action.seriesIds` | Yes | When `action.kind` is `create`: array; items: integer; greater than 0; max items 200 |
| `action.imageTaskIds` | No | When `action.kind` is `create`: array; items: string; pattern `^[A-Za-z0-9_-]{8,80}$`; min items 1; max items 3 |
| `action.reviewId` | Yes | When `action.kind` is `edit`: integer; greater than 0 |
| `action.changes` | Yes | When `action.kind` is `edit`: object |
| `action.changes.content` | No | When `action.kind` is `edit`: string |
| `action.changes.score` | No | When `action.kind` is `edit`: integer; minimum 1; maximum 5 |
| `action.changes.seriesIds` | No | When `action.kind` is `edit`: array; items: integer; greater than 0; max items 200 |
| `action.changes.clearImages` | No | When `action.kind` is `edit`: `true` |
| `action.changes.removeImagePositions` | No | When `action.kind` is `edit`: array; items: integer; minimum 1; maximum 1000; min items 1; max items 1000 |
| `action.changes.addImageTaskIds` | No | When `action.kind` is `edit`: array; items: string; pattern `^[A-Za-z0-9_-]{8,80}$`; min items 1; max items 3 |
| `action.reviewIds` | Yes | When `action.kind` is `publish`: array; items: integer; greater than 0; min items 1; max items 100 |
| `action.isPublished` | Yes | When `action.kind` is `publish`: boolean |
| `action.reviewIds` | Yes | When `action.kind` is `delete`: array; items: integer; greater than 0; min items 1; max items 100 |
| `action.confirmation` | Yes | When `action.kind` is `delete`: `DELETE_COURSE_REVIEWS` |
| `confirmToken` | No | string; pattern `^ct[a-f\d]{32}$`; The confirmToken from this tool's preview result. Omit it to preview; repeat the same input with it to execute. |