> ## Documentation Index
> Fetch the complete documentation index at: https://docs.atlaswork.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Re-run detection on the envelope under review

> Re-triggers the detection pipeline for the token's envelope — the recovery path after a failed/empty detection or after editing participants. Allowed only in `draft`/`review`; rate-limited to 5 runs per envelope per hour. Manually placed fields survive re-detection (§6.7). Requires a read-capable token.



## OpenAPI

````yaml /openapi.json post /api/review/redetect
openapi: 3.0.0
info:
  title: Atlas API
  version: 0.0.0
servers:
  - url: https://api.atlaswork.ai
security: []
paths:
  /api/review/redetect:
    post:
      tags:
        - review
      summary: Re-run detection on the envelope under review
      description: >-
        Re-triggers the detection pipeline for the token's envelope — the
        recovery path after a failed/empty detection or after editing
        participants. Allowed only in `draft`/`review`; rate-limited to 5 runs
        per envelope per hour. Manually placed fields survive re-detection
        (§6.7). Requires a read-capable token.
      responses:
        '202':
          description: Detection was requested (runs asynchronously)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReviewRedetectResponse'
        '401':
          description: Missing or invalid review token
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                  message:
                    type: string
                  details:
                    type: object
                    additionalProperties:
                      nullable: true
                required:
                  - code
                  - message
        '403':
          description: Token lacks read capability
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                  message:
                    type: string
                  details:
                    type: object
                    additionalProperties:
                      nullable: true
                required:
                  - code
                  - message
        '404':
          description: The token's envelope no longer exists
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                  message:
                    type: string
                  details:
                    type: object
                    additionalProperties:
                      nullable: true
                required:
                  - code
                  - message
        '422':
          description: Envelope is not in draft/review
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                  message:
                    type: string
                  details:
                    type: object
                    additionalProperties:
                      nullable: true
                required:
                  - code
                  - message
        '429':
          description: Too many detection runs in the last hour
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                  message:
                    type: string
                  details:
                    type: object
                    additionalProperties:
                      nullable: true
                required:
                  - code
                  - message
      security:
        - reviewToken: []
components:
  schemas:
    ReviewRedetectResponse:
      type: object
      properties:
        status:
          type: string
          enum:
            - requested
      required:
        - status
  securitySchemes:
    reviewToken:
      type: http
      scheme: bearer
      description: >-
        HMAC-signed review token (minted into the envelope's review URL at
        creation), as a bearer token or a `token` query param. Capabilities are
        split per token: a read token grants view + draft editing, a send token
        grants the dispatch action only — so a forwarded review link can be
        shared read-only. Scoped to exactly one envelope; never valid as a
        signer credential.

````