---
title: "Read the version's screenplay coverage gate."
method: GET
path: "/scripts/{scriptUploadId}/coverage/acknowledge"
tags: ["Scripts"]
---

# Read the version's screenplay coverage gate.

`GET /scripts/{scriptUploadId}/coverage/acknowledge`

## Request

- Base URL: `https://docs.sleeperhit.studio/api/v1`
- URL: `https://docs.sleeperhit.studio/api/v1/scripts/{scriptUploadId}/coverage/acknowledge`
- Auth: HTTP bearer

Where the version's screenplay coverage gate stands: open or not (casting, voices and the table read wait on it), the newest complete report's score, bar and reasons, and `override`: whether the writer may continue over it, and why not. Records nothing. Read-only; costs no credits.

## Response `200`

The gate.

- ScreenplayCoverageGateResponse
  - `gate` ScreenplayCoverageGate, required: Where the version's screenplay coverage gate stands. `open`: casting (and so voices and the table read) may start, each still quoted.
    - `scriptUploadId` string, required
    - `versionNumber` integer, required
    - `open` boolean, required
    - `status` 'not_in_project' | 'story_film' | 'draft' | 'no_report' | 'scoring' | 'below_bar' | 'passed' | 'acknowledged', required: `passed` and `acknowledged` are open; `not_in_project` has no gate; `story_film` is a story film's script, open on the story film judge's pass instead of the screenplay coverage bar (its table read, cast and voices never wait on screenplay coverage).
    - `reportId` string, nullable, required: The newest complete screenplay report on the version: the one an acknowledgement names.
    - `overallScore` number, nullable, required
    - `gateThreshold` number, required
    - `reasons` string[], required
    - `acknowledgement` ScreenplayCoverageAcknowledgement, required: The writer's choice to continue over this version's screenplay coverage, recorded on the report it acknowledges.
      - `scriptUploadId` string, required
      - `versionNumber` integer, required
      - `reportId` string, required
      - `contentHash` string, required: The fingerprint of the version's text when acknowledged: a change to the text voids it.
      - `overallScore` number, required
      - `gateThreshold` number, required
      - `reasons` string[], required: What the report said, as the writer was shown it.
      - `reason` string, required: The writer's own reason.
      - `at` string, date-time, required
      - `by` object, required
        - `userId` string, required
        - `surface` 'app' | 'slug' | 'api', required
        - `keyId` string, nullable, required
    - `override` object, required
      - `allowed` boolean, required
      - `why` string, required

## Other responses

- `401`: Missing, malformed, revoked, or expired API key.
- `403`: API key is valid but lacks the scope, is blocked by IP allowlist, or the account is disabled.
- `404`: The named project or source does not exist or is owned by another account.
- `429`: Rate limit for this API key + IP + route family was exceeded.
- `500`: The API failed unexpectedly. Safe to retry with the same Idempotency-Key.

---

[API](https://skmtc.dev/sleeperhit/apis/sleeper-hit-studio-story-api.md) · [All operations](https://skmtc.dev/sleeperhit/apis/sleeper-hit-studio-story-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sleeperhit/apis/sleeper-hit-studio-story-api/revisions/4534f5d25540?raw)