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

# Skip Auto-Claim

> Suppresses the schedule's runs on a single date or across an inclusive date range without deleting it; runs resume automatically after the window. Requires the auto-claim-rewards capability.



## OpenAPI

````yaml POST /api/v1/accounts/{account-id}/auto-claims/{schedule-id}/skips
openapi: 3.1.0
info:
  title: Crown API & Webhooks
  version: 1.0.0
  description: >-
    Open API 3 docs for Crown API


    Webhook events that Crown will POST to your configured endpoint URL. All
    webhooks expect a 200 OK response. Payloads use kebab-case for all keys to
    match the Crown API conventions.
servers:
  - url: https://app.crown-brlv.com
    description: Production server
security: []
paths:
  /api/v1/accounts/{account-id}/auto-claims/{schedule-id}/skips:
    post:
      summary: Skip an auto-claim on a date or period
      description: >-
        Suppresses the schedule's runs on a single date or across an inclusive
        date range without deleting it; runs resume automatically after the
        window. Requires the auto-claim-rewards capability.
      parameters:
        - in: path
          name: account-id
          required: true
          schema:
            type: string
            format: uuid
        - in: path
          name: schedule-id
          required: true
          schema:
            type: string
            format: uuid
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                date:
                  type: string
                  description: Single day to skip (YYYY-MM-DD); shorthand for from=to
                  example: '2026-07-01'
                from:
                  type: string
                  description: Start of the skip window, inclusive (YYYY-MM-DD)
                  example: '2026-07-01'
                to:
                  type: string
                  description: End of the skip window, inclusive (YYYY-MM-DD)
                  example: '2026-07-15'
                reason:
                  type: string
                  description: Optional note recorded with the skip
              additionalProperties: false
      responses:
        '200':
          description: Skip window created
          content:
            application/json:
              schema:
                type: object
                properties:
                  auto-claim-skip:
                    type: object
                    properties:
                      id:
                        type: string
                        format: uuid
                        description: Skip window unique identifier
                      starts-on:
                        type: string
                        description: First day skipped, inclusive
                        example: '2026-07-01'
                      ends-on:
                        type: string
                        description: Last day skipped, inclusive
                        example: '2026-07-15'
                      reason:
                        oneOf:
                          - type: string
                          - type: 'null'
                        description: Note recorded with the skip, or null
                      created-at:
                        type: string
                        description: Creation timestamp
                    additionalProperties: false
                    required:
                      - id
                      - starts-on
                      - ends-on
                      - reason
                      - created-at
                    description: The created skip window
                additionalProperties: false
                required:
                  - auto-claim-skip
        '400':
          description: Bad request - Invalid input parameters
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      type:
                        type: string
                      message:
                        type: string
                      code:
                        type: string
                    additionalProperties: false
                    required:
                      - type
                      - message
                      - code
                    description: Bad request error details
                additionalProperties: false
                required:
                  - error
        '403':
          description: Forbidden - Access denied
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      type:
                        type: string
                      message:
                        type: string
                      code:
                        type: string
                    additionalProperties: false
                    required:
                      - type
                      - message
                      - code
                    description: Forbidden access error details
                additionalProperties: false
                required:
                  - error
        '404':
          description: Not found - Resource does not exist
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      type:
                        type: string
                      message:
                        type: string
                      code:
                        type: string
                    additionalProperties: false
                    required:
                      - type
                      - message
                      - code
                    description: Resource not found error details
                additionalProperties: false
                required:
                  - error
        '422':
          description: Unprocessable entity - Validation failed
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      type:
                        type: string
                      message:
                        type: string
                      code:
                        type: string
                    additionalProperties: false
                    required:
                      - type
                      - message
                      - code
                    description: Validation error details
                additionalProperties: false
                required:
                  - error

````