Artifacts

Flag one table-read line for review.

Flags ONE line of a table_read artifact for the writer's review, with an optional note: pass the line's entryIndex, the lineText as it stands, and optionally character (null or omitted for narration) and note. One flag per line (keyed by (jobId, entryIndex)) — flagging a line again replaces its note rather than adding a second, so the same flag always lands and a retry is safe. An unknown field, a wrong-typed value or a missing lineText is refused with 400 validation_failed — the same validation MCP flag_line_for_review and sleeperhit script review flag go through. Answers the flag as it now stands. Free and naturally idempotent, so no Idempotency-Key: it renders nothing.

post/artifacts/{artifactId}/review-items

Request

  • Base URL: https://docs.sleeperhit.studio/api/v1
  • URL: https://docs.sleeperhit.studio/api/v1/artifacts/{artifactId}/review-items
  • Auth: HTTP bearer

Request body

entryIndexinteger required

Which line: its index in the read's parsed screenplay.

lineTextstring required

The line's text as it stands.

characterstring nullable

Who speaks the line; null or omitted for narration.

notestring nullable

The writer's note on why it needs review.

Response

The flag as it now stands.

artifactIdstring required

Changes

No recorded changes to this operation across all 1 revision of this API.