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

# Rotate a webhook secret

> Rotates the secret with a bounded overlap and displays the new secret once.



## OpenAPI

````yaml /api-reference/blank-api-v2.yaml post /webhook-endpoints/{endpointId}/secret-rotations
openapi: 3.1.1
info:
  description: Production developer API for Blank automation-grade product capabilities.
  title: Blank API
  version: 2.0.0
servers:
  - description: Production
    url: https://api.blank.build/api/v2
security: []
tags:
  - description: Platform and Solana integration metadata.
    name: System
  - description: Current API-key identity.
    name: Identity
  - description: Token resources and management.
    name: Tokens
  - description: Price, trade, candle, liquidity, and holder data.
    name: Market data
  - description: Launch resources and transaction intents.
    name: Launches
  - description: Quotes and transaction intents.
    name: Trading
  - description: Pools, positions, and transaction intents.
    name: Staking
  - description: Fee state, distributions, and claim intents.
    name: Fees
  - description: Presale resources and participant actions.
    name: Presales
  - description: Prediction rounds, entries, and standings.
    name: Predictions
  - description: Asynchronous audience exports.
    name: Audience
  - description: Owned asynchronous operation status.
    name: Operations
  - description: Outbound webhook configuration and deliveries.
    name: Webhooks
paths:
  /webhook-endpoints/{endpointId}/secret-rotations:
    post:
      tags:
        - Webhooks
      summary: Rotate a webhook secret
      description: >-
        Rotates the secret with a bounded overlap and displays the new secret
        once.
      operationId: rotateWebhookSecret
      parameters:
        - in: path
          name: endpointId
          required: true
          schema:
            format: uuid
            type: string
        - in: header
          name: idempotency-key
          required: true
          schema:
            example: launch-20260809-01
            maxLength: 128
            minLength: 8
            pattern: ^[\x21-\x7E]+$
            type: string
        - in: header
          name: if-match
          required: true
          schema:
            example: '"1"'
            pattern: ^"[1-9][0-9]*"$
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/WebhookSecretRotation'
        required: true
      responses:
        '201':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WebhookEndpointWithSecret'
          description: Endpoint and new one-time secret.
        '400':
          content:
            application/problem+json:
              schema:
                oneOf:
                  - allOf:
                      - $ref: '#/components/schemas/ProblemDetails'
                      - properties:
                          code:
                            enum:
                              - precondition_invalid
                            type: string
                          status:
                            enum:
                              - 400
                            type: number
                          title:
                            enum:
                              - Invalid precondition
                            type: string
                          type:
                            enum:
                              - >-
                                https://blank.build/docs/reference/errors#precondition_invalid
                            type: string
                        type: object
                  - allOf:
                      - $ref: '#/components/schemas/ProblemDetails'
                      - properties:
                          code:
                            enum:
                              - malformed_json
                            type: string
                          status:
                            enum:
                              - 400
                            type: number
                          title:
                            enum:
                              - Malformed JSON
                            type: string
                          type:
                            enum:
                              - >-
                                https://blank.build/docs/reference/errors#malformed_json
                            type: string
                        type: object
                  - allOf:
                      - $ref: '#/components/schemas/ProblemDetails'
                      - properties:
                          code:
                            enum:
                              - idempotency_key_invalid
                            type: string
                          status:
                            enum:
                              - 400
                            type: number
                          title:
                            enum:
                              - Invalid idempotency key
                            type: string
                          type:
                            enum:
                              - >-
                                https://blank.build/docs/reference/errors#idempotency_key_invalid
                            type: string
                        type: object
          description: >-
            Problem response. Possible codes: idempotency_key_invalid,
            malformed_json, precondition_invalid.
          headers:
            Cache-Control:
              description: Error responses are private and never cached.
              required: true
              schema:
                description: Error responses are private and never cached.
                enum:
                  - private, no-store
                type: string
            Vary:
              description: The response varies by authorization context.
              required: true
              schema:
                description: The response varies by authorization context.
                enum:
                  - Authorization
                type: string
            X-Blank-Api-Version:
              description: Public API major version.
              required: true
              schema:
                description: Public API major version.
                enum:
                  - '2'
                type: string
            X-Duration-Ms:
              description: Server-side request duration in milliseconds.
              required: true
              schema:
                description: Server-side request duration in milliseconds.
                pattern: ^[0-9]+$
                type: string
            X-Request-Id:
              description: Request identifier matching Problem Details requestId.
              required: true
              schema:
                description: Request identifier matching Problem Details requestId.
                type: string
            traceparent:
              description: W3C trace context for correlation.
              required: true
              schema:
                description: W3C trace context for correlation.
                type: string
        '401':
          content:
            application/problem+json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/ProblemDetails'
                  - properties:
                      code:
                        enum:
                          - invalid_api_key
                        type: string
                      status:
                        enum:
                          - 401
                        type: number
                      title:
                        enum:
                          - Invalid API key
                        type: string
                      type:
                        enum:
                          - >-
                            https://blank.build/docs/reference/errors#invalid_api_key
                        type: string
                    type: object
          description: 'Problem response. Possible codes: invalid_api_key.'
          headers:
            Cache-Control:
              description: Error responses are private and never cached.
              required: true
              schema:
                description: Error responses are private and never cached.
                enum:
                  - private, no-store
                type: string
            Vary:
              description: The response varies by authorization context.
              required: true
              schema:
                description: The response varies by authorization context.
                enum:
                  - Authorization
                type: string
            X-Blank-Api-Version:
              description: Public API major version.
              required: true
              schema:
                description: Public API major version.
                enum:
                  - '2'
                type: string
            X-Duration-Ms:
              description: Server-side request duration in milliseconds.
              required: true
              schema:
                description: Server-side request duration in milliseconds.
                pattern: ^[0-9]+$
                type: string
            X-Request-Id:
              description: Request identifier matching Problem Details requestId.
              required: true
              schema:
                description: Request identifier matching Problem Details requestId.
                type: string
            traceparent:
              description: W3C trace context for correlation.
              required: true
              schema:
                description: W3C trace context for correlation.
                type: string
        '403':
          content:
            application/problem+json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/ProblemDetails'
                  - properties:
                      code:
                        enum:
                          - insufficient_scope
                        type: string
                      status:
                        enum:
                          - 403
                        type: number
                      title:
                        enum:
                          - Insufficient scope
                        type: string
                      type:
                        enum:
                          - >-
                            https://blank.build/docs/reference/errors#insufficient_scope
                        type: string
                    type: object
          description: 'Problem response. Possible codes: insufficient_scope.'
          headers:
            Cache-Control:
              description: Error responses are private and never cached.
              required: true
              schema:
                description: Error responses are private and never cached.
                enum:
                  - private, no-store
                type: string
            Vary:
              description: The response varies by authorization context.
              required: true
              schema:
                description: The response varies by authorization context.
                enum:
                  - Authorization
                type: string
            X-Blank-Api-Version:
              description: Public API major version.
              required: true
              schema:
                description: Public API major version.
                enum:
                  - '2'
                type: string
            X-Duration-Ms:
              description: Server-side request duration in milliseconds.
              required: true
              schema:
                description: Server-side request duration in milliseconds.
                pattern: ^[0-9]+$
                type: string
            X-Request-Id:
              description: Request identifier matching Problem Details requestId.
              required: true
              schema:
                description: Request identifier matching Problem Details requestId.
                type: string
            traceparent:
              description: W3C trace context for correlation.
              required: true
              schema:
                description: W3C trace context for correlation.
                type: string
        '404':
          content:
            application/problem+json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/ProblemDetails'
                  - properties:
                      code:
                        enum:
                          - webhook_endpoint_not_found
                        type: string
                      status:
                        enum:
                          - 404
                        type: number
                      title:
                        enum:
                          - Webhook endpoint not found
                        type: string
                      type:
                        enum:
                          - >-
                            https://blank.build/docs/reference/errors#webhook_endpoint_not_found
                        type: string
                    type: object
          description: 'Problem response. Possible codes: webhook_endpoint_not_found.'
          headers:
            Cache-Control:
              description: Error responses are private and never cached.
              required: true
              schema:
                description: Error responses are private and never cached.
                enum:
                  - private, no-store
                type: string
            Vary:
              description: The response varies by authorization context.
              required: true
              schema:
                description: The response varies by authorization context.
                enum:
                  - Authorization
                type: string
            X-Blank-Api-Version:
              description: Public API major version.
              required: true
              schema:
                description: Public API major version.
                enum:
                  - '2'
                type: string
            X-Duration-Ms:
              description: Server-side request duration in milliseconds.
              required: true
              schema:
                description: Server-side request duration in milliseconds.
                pattern: ^[0-9]+$
                type: string
            X-Request-Id:
              description: Request identifier matching Problem Details requestId.
              required: true
              schema:
                description: Request identifier matching Problem Details requestId.
                type: string
            traceparent:
              description: W3C trace context for correlation.
              required: true
              schema:
                description: W3C trace context for correlation.
                type: string
        '409':
          content:
            application/problem+json:
              schema:
                oneOf:
                  - allOf:
                      - $ref: '#/components/schemas/ProblemDetails'
                      - properties:
                          code:
                            enum:
                              - idempotency_key_reused
                            type: string
                          status:
                            enum:
                              - 409
                            type: number
                          title:
                            enum:
                              - Idempotency key reused
                            type: string
                          type:
                            enum:
                              - >-
                                https://blank.build/docs/reference/errors#idempotency_key_reused
                            type: string
                        type: object
                  - allOf:
                      - $ref: '#/components/schemas/ProblemDetails'
                      - properties:
                          code:
                            enum:
                              - idempotency_request_in_progress
                            type: string
                          status:
                            enum:
                              - 409
                            type: number
                          title:
                            enum:
                              - Idempotency request in progress
                            type: string
                          type:
                            enum:
                              - >-
                                https://blank.build/docs/reference/errors#idempotency_request_in_progress
                            type: string
                        type: object
          description: >-
            Problem response. Possible codes: idempotency_key_reused,
            idempotency_request_in_progress.
          headers:
            Cache-Control:
              description: Error responses are private and never cached.
              required: true
              schema:
                description: Error responses are private and never cached.
                enum:
                  - private, no-store
                type: string
            Retry-After:
              description: Minimum delay in seconds before a safe retry.
              required: true
              schema:
                description: Minimum delay in seconds before a safe retry.
                pattern: ^[0-9]+$
                type: string
            Vary:
              description: The response varies by authorization context.
              required: true
              schema:
                description: The response varies by authorization context.
                enum:
                  - Authorization
                type: string
            X-Blank-Api-Version:
              description: Public API major version.
              required: true
              schema:
                description: Public API major version.
                enum:
                  - '2'
                type: string
            X-Duration-Ms:
              description: Server-side request duration in milliseconds.
              required: true
              schema:
                description: Server-side request duration in milliseconds.
                pattern: ^[0-9]+$
                type: string
            X-Request-Id:
              description: Request identifier matching Problem Details requestId.
              required: true
              schema:
                description: Request identifier matching Problem Details requestId.
                type: string
            traceparent:
              description: W3C trace context for correlation.
              required: true
              schema:
                description: W3C trace context for correlation.
                type: string
        '412':
          content:
            application/problem+json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/ProblemDetails'
                  - properties:
                      code:
                        enum:
                          - precondition_failed
                        type: string
                      status:
                        enum:
                          - 412
                        type: number
                      title:
                        enum:
                          - Precondition failed
                        type: string
                      type:
                        enum:
                          - >-
                            https://blank.build/docs/reference/errors#precondition_failed
                        type: string
                    type: object
          description: 'Problem response. Possible codes: precondition_failed.'
          headers:
            Cache-Control:
              description: Error responses are private and never cached.
              required: true
              schema:
                description: Error responses are private and never cached.
                enum:
                  - private, no-store
                type: string
            Vary:
              description: The response varies by authorization context.
              required: true
              schema:
                description: The response varies by authorization context.
                enum:
                  - Authorization
                type: string
            X-Blank-Api-Version:
              description: Public API major version.
              required: true
              schema:
                description: Public API major version.
                enum:
                  - '2'
                type: string
            X-Duration-Ms:
              description: Server-side request duration in milliseconds.
              required: true
              schema:
                description: Server-side request duration in milliseconds.
                pattern: ^[0-9]+$
                type: string
            X-Request-Id:
              description: Request identifier matching Problem Details requestId.
              required: true
              schema:
                description: Request identifier matching Problem Details requestId.
                type: string
            traceparent:
              description: W3C trace context for correlation.
              required: true
              schema:
                description: W3C trace context for correlation.
                type: string
        '413':
          content:
            application/problem+json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/ProblemDetails'
                  - properties:
                      code:
                        enum:
                          - request_body_too_large
                        type: string
                      status:
                        enum:
                          - 413
                        type: number
                      title:
                        enum:
                          - Request body too large
                        type: string
                      type:
                        enum:
                          - >-
                            https://blank.build/docs/reference/errors#request_body_too_large
                        type: string
                    type: object
          description: 'Problem response. Possible codes: request_body_too_large.'
          headers:
            Cache-Control:
              description: Error responses are private and never cached.
              required: true
              schema:
                description: Error responses are private and never cached.
                enum:
                  - private, no-store
                type: string
            Vary:
              description: The response varies by authorization context.
              required: true
              schema:
                description: The response varies by authorization context.
                enum:
                  - Authorization
                type: string
            X-Blank-Api-Version:
              description: Public API major version.
              required: true
              schema:
                description: Public API major version.
                enum:
                  - '2'
                type: string
            X-Duration-Ms:
              description: Server-side request duration in milliseconds.
              required: true
              schema:
                description: Server-side request duration in milliseconds.
                pattern: ^[0-9]+$
                type: string
            X-Request-Id:
              description: Request identifier matching Problem Details requestId.
              required: true
              schema:
                description: Request identifier matching Problem Details requestId.
                type: string
            traceparent:
              description: W3C trace context for correlation.
              required: true
              schema:
                description: W3C trace context for correlation.
                type: string
        '415':
          content:
            application/problem+json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/ProblemDetails'
                  - properties:
                      code:
                        enum:
                          - unsupported_content_type
                        type: string
                      status:
                        enum:
                          - 415
                        type: number
                      title:
                        enum:
                          - Unsupported content type
                        type: string
                      type:
                        enum:
                          - >-
                            https://blank.build/docs/reference/errors#unsupported_content_type
                        type: string
                    type: object
          description: 'Problem response. Possible codes: unsupported_content_type.'
          headers:
            Cache-Control:
              description: Error responses are private and never cached.
              required: true
              schema:
                description: Error responses are private and never cached.
                enum:
                  - private, no-store
                type: string
            Vary:
              description: The response varies by authorization context.
              required: true
              schema:
                description: The response varies by authorization context.
                enum:
                  - Authorization
                type: string
            X-Blank-Api-Version:
              description: Public API major version.
              required: true
              schema:
                description: Public API major version.
                enum:
                  - '2'
                type: string
            X-Duration-Ms:
              description: Server-side request duration in milliseconds.
              required: true
              schema:
                description: Server-side request duration in milliseconds.
                pattern: ^[0-9]+$
                type: string
            X-Request-Id:
              description: Request identifier matching Problem Details requestId.
              required: true
              schema:
                description: Request identifier matching Problem Details requestId.
                type: string
            traceparent:
              description: W3C trace context for correlation.
              required: true
              schema:
                description: W3C trace context for correlation.
                type: string
        '422':
          content:
            application/problem+json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/ProblemDetails'
                  - properties:
                      code:
                        enum:
                          - validation_failed
                        type: string
                      status:
                        enum:
                          - 422
                        type: number
                      title:
                        enum:
                          - Validation failed
                        type: string
                      type:
                        enum:
                          - >-
                            https://blank.build/docs/reference/errors#validation_failed
                        type: string
                    type: object
          description: 'Problem response. Possible codes: validation_failed.'
          headers:
            Cache-Control:
              description: Error responses are private and never cached.
              required: true
              schema:
                description: Error responses are private and never cached.
                enum:
                  - private, no-store
                type: string
            Vary:
              description: The response varies by authorization context.
              required: true
              schema:
                description: The response varies by authorization context.
                enum:
                  - Authorization
                type: string
            X-Blank-Api-Version:
              description: Public API major version.
              required: true
              schema:
                description: Public API major version.
                enum:
                  - '2'
                type: string
            X-Duration-Ms:
              description: Server-side request duration in milliseconds.
              required: true
              schema:
                description: Server-side request duration in milliseconds.
                pattern: ^[0-9]+$
                type: string
            X-Request-Id:
              description: Request identifier matching Problem Details requestId.
              required: true
              schema:
                description: Request identifier matching Problem Details requestId.
                type: string
            traceparent:
              description: W3C trace context for correlation.
              required: true
              schema:
                description: W3C trace context for correlation.
                type: string
        '428':
          content:
            application/problem+json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/ProblemDetails'
                  - properties:
                      code:
                        enum:
                          - precondition_required
                        type: string
                      status:
                        enum:
                          - 428
                        type: number
                      title:
                        enum:
                          - Precondition required
                        type: string
                      type:
                        enum:
                          - >-
                            https://blank.build/docs/reference/errors#precondition_required
                        type: string
                    type: object
          description: 'Problem response. Possible codes: precondition_required.'
          headers:
            Cache-Control:
              description: Error responses are private and never cached.
              required: true
              schema:
                description: Error responses are private and never cached.
                enum:
                  - private, no-store
                type: string
            Vary:
              description: The response varies by authorization context.
              required: true
              schema:
                description: The response varies by authorization context.
                enum:
                  - Authorization
                type: string
            X-Blank-Api-Version:
              description: Public API major version.
              required: true
              schema:
                description: Public API major version.
                enum:
                  - '2'
                type: string
            X-Duration-Ms:
              description: Server-side request duration in milliseconds.
              required: true
              schema:
                description: Server-side request duration in milliseconds.
                pattern: ^[0-9]+$
                type: string
            X-Request-Id:
              description: Request identifier matching Problem Details requestId.
              required: true
              schema:
                description: Request identifier matching Problem Details requestId.
                type: string
            traceparent:
              description: W3C trace context for correlation.
              required: true
              schema:
                description: W3C trace context for correlation.
                type: string
        '429':
          content:
            application/problem+json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/ProblemDetails'
                  - properties:
                      code:
                        enum:
                          - rate_limit_exceeded
                        type: string
                      status:
                        enum:
                          - 429
                        type: number
                      title:
                        enum:
                          - Rate limit exceeded
                        type: string
                      type:
                        enum:
                          - >-
                            https://blank.build/docs/reference/errors#rate_limit_exceeded
                        type: string
                    type: object
          description: 'Problem response. Possible codes: rate_limit_exceeded.'
          headers:
            Cache-Control:
              description: Error responses are private and never cached.
              required: true
              schema:
                description: Error responses are private and never cached.
                enum:
                  - private, no-store
                type: string
            Retry-After:
              description: Minimum delay in seconds before a safe retry.
              required: true
              schema:
                description: Minimum delay in seconds before a safe retry.
                pattern: ^[0-9]+$
                type: string
            Vary:
              description: The response varies by authorization context.
              required: true
              schema:
                description: The response varies by authorization context.
                enum:
                  - Authorization
                type: string
            X-Blank-Api-Version:
              description: Public API major version.
              required: true
              schema:
                description: Public API major version.
                enum:
                  - '2'
                type: string
            X-Duration-Ms:
              description: Server-side request duration in milliseconds.
              required: true
              schema:
                description: Server-side request duration in milliseconds.
                pattern: ^[0-9]+$
                type: string
            X-Request-Id:
              description: Request identifier matching Problem Details requestId.
              required: true
              schema:
                description: Request identifier matching Problem Details requestId.
                type: string
            traceparent:
              description: W3C trace context for correlation.
              required: true
              schema:
                description: W3C trace context for correlation.
                type: string
        '500':
          content:
            application/problem+json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/ProblemDetails'
                  - properties:
                      code:
                        enum:
                          - internal_error
                        type: string
                      status:
                        enum:
                          - 500
                        type: number
                      title:
                        enum:
                          - Internal server error
                        type: string
                      type:
                        enum:
                          - >-
                            https://blank.build/docs/reference/errors#internal_error
                        type: string
                    type: object
          description: 'Problem response. Possible codes: internal_error.'
          headers:
            Cache-Control:
              description: Error responses are private and never cached.
              required: true
              schema:
                description: Error responses are private and never cached.
                enum:
                  - private, no-store
                type: string
            Vary:
              description: The response varies by authorization context.
              required: true
              schema:
                description: The response varies by authorization context.
                enum:
                  - Authorization
                type: string
            X-Blank-Api-Version:
              description: Public API major version.
              required: true
              schema:
                description: Public API major version.
                enum:
                  - '2'
                type: string
            X-Duration-Ms:
              description: Server-side request duration in milliseconds.
              required: true
              schema:
                description: Server-side request duration in milliseconds.
                pattern: ^[0-9]+$
                type: string
            X-Request-Id:
              description: Request identifier matching Problem Details requestId.
              required: true
              schema:
                description: Request identifier matching Problem Details requestId.
                type: string
            traceparent:
              description: W3C trace context for correlation.
              required: true
              schema:
                description: W3C trace context for correlation.
                type: string
        '503':
          content:
            application/problem+json:
              schema:
                oneOf:
                  - allOf:
                      - $ref: '#/components/schemas/ProblemDetails'
                      - properties:
                          code:
                            enum:
                              - rate_limit_unavailable
                            type: string
                          status:
                            enum:
                              - 503
                            type: number
                          title:
                            enum:
                              - Rate limiting unavailable
                            type: string
                          type:
                            enum:
                              - >-
                                https://blank.build/docs/reference/errors#rate_limit_unavailable
                            type: string
                        type: object
                  - allOf:
                      - $ref: '#/components/schemas/ProblemDetails'
                      - properties:
                          code:
                            enum:
                              - api_dependency_unavailable
                            type: string
                          status:
                            enum:
                              - 503
                            type: number
                          title:
                            enum:
                              - API dependency unavailable
                            type: string
                          type:
                            enum:
                              - >-
                                https://blank.build/docs/reference/errors#api_dependency_unavailable
                            type: string
                        type: object
          description: >-
            Problem response. Possible codes: api_dependency_unavailable,
            rate_limit_unavailable.
          headers:
            Cache-Control:
              description: Error responses are private and never cached.
              required: true
              schema:
                description: Error responses are private and never cached.
                enum:
                  - private, no-store
                type: string
            Retry-After:
              description: Minimum delay in seconds before a safe retry.
              required: true
              schema:
                description: Minimum delay in seconds before a safe retry.
                pattern: ^[0-9]+$
                type: string
            Vary:
              description: The response varies by authorization context.
              required: true
              schema:
                description: The response varies by authorization context.
                enum:
                  - Authorization
                type: string
            X-Blank-Api-Version:
              description: Public API major version.
              required: true
              schema:
                description: Public API major version.
                enum:
                  - '2'
                type: string
            X-Duration-Ms:
              description: Server-side request duration in milliseconds.
              required: true
              schema:
                description: Server-side request duration in milliseconds.
                pattern: ^[0-9]+$
                type: string
            X-Request-Id:
              description: Request identifier matching Problem Details requestId.
              required: true
              schema:
                description: Request identifier matching Problem Details requestId.
                type: string
            traceparent:
              description: W3C trace context for correlation.
              required: true
              schema:
                description: W3C trace context for correlation.
                type: string
      security:
        - BlankApiKey: []
components:
  schemas:
    WebhookSecretRotation:
      additionalProperties: false
      properties:
        overlapHours:
          default: 24
          maximum: 24
          minimum: 1
          type: integer
      type: object
    WebhookEndpointWithSecret:
      properties:
        endpoint:
          $ref: '#/components/schemas/WebhookEndpoint'
        secret:
          pattern: ^whsec_[A-Za-z0-9_-]{43}$
          type: string
      required:
        - endpoint
        - secret
      type: object
    ProblemDetails:
      properties:
        causes:
          items:
            $ref: '#/components/schemas/ProblemCause'
          maxItems: 20
          type: array
        code:
          enum:
            - invalid_api_key
            - insufficient_scope
            - not_found
            - method_not_allowed
            - precondition_required
            - precondition_invalid
            - validation_failed
            - malformed_json
            - unsupported_content_type
            - request_body_too_large
            - idempotency_key_invalid
            - idempotency_key_reused
            - idempotency_request_in_progress
            - precondition_failed
            - cursor_invalid
            - rate_limit_exceeded
            - rate_limit_unavailable
            - api_dependency_unavailable
            - internal_error
            - invalid_error_response
            - token_not_found
            - holder_stats_not_found
            - market_time_range_invalid
            - token_index_unavailable
            - market_data_unavailable
            - identity_unavailable
            - staking_pool_not_found
            - presale_not_found
            - presale_participation_not_found
            - manifest_unavailable
            - prediction_wallet_mismatch
            - prediction_authorization_invalid
            - prediction_intent_not_found
            - prediction_round_not_found
            - prediction_not_found
            - prediction_token_not_enabled
            - prediction_round_not_open
            - prediction_wallet_not_verified
            - prediction_username_required
            - prediction_insufficient_balance
            - prediction_already_submitted
            - prediction_intent_expired
            - prediction_intent_consumed
            - prediction_exact_values_locked
            - prediction_price_out_of_range
            - prediction_balance_unavailable
            - operation_not_found
            - transaction_intent_not_found
            - transaction_intent_not_prepared
            - transaction_intent_expired
            - transaction_intent_version_conflict
            - transaction_intent_tampered
            - transaction_intent_wrong_signer
            - transaction_intent_invalid_signature
            - webhook_endpoint_not_found
            - webhook_delivery_not_found
            - webhook_delivery_not_replayable
            - webhook_endpoint_limit_reached
            - webhook_delivery_replay_limit_reached
            - webhook_url_disallowed
          type: string
        context:
          additionalProperties:
            oneOf:
              - maxLength: 1024
                type: string
              - type: number
              - type: boolean
              - type: 'null'
          type: object
        detail:
          maxLength: 2000
          minLength: 1
          type: string
        errors:
          items:
            $ref: '#/components/schemas/ProblemFieldError'
          maxItems: 100
          type: array
        instance:
          maxLength: 2048
          minLength: 1
          type: string
        requestId:
          example: req_0123456789abcdef0123456789abcdef
          pattern: ^req_[0-9a-f]{32}$
          type: string
        status:
          maximum: 599
          minimum: 400
          type: integer
        title:
          maxLength: 200
          minLength: 1
          type: string
        type:
          minLength: 1
          type: string
      required:
        - type
        - title
        - status
        - detail
        - instance
        - code
        - requestId
      type:
        - object
        - 'null'
    WebhookEndpoint:
      properties:
        createdAt:
          format: date-time
          type: string
        eventTypes:
          items:
            enum:
              - build.blank.launch.created.v1
              - build.blank.launch.confirmed.v1
              - build.blank.trade.confirmed.v1
              - build.blank.staking.position.updated.v1
              - build.blank.fee.distribution.created.v1
              - build.blank.prediction.submitted.v1
              - build.blank.prediction.round.locked.v1
              - build.blank.prediction.round.settled.v1
              - build.blank.presale.updated.v1
              - build.blank.audience-export.completed.v1
              - build.blank.operation.failed.v1
            type: string
          maxItems: 11
          minItems: 1
          type: array
        id:
          format: uuid
          type: string
        name:
          maxLength: 80
          minLength: 1
          type: string
        status:
          enum:
            - active
            - disabled
          type: string
        updatedAt:
          format: date-time
          type: string
        url:
          format: uri
          type: string
        version:
          exclusiveMinimum: 0
          type: integer
      required:
        - id
        - name
        - url
        - eventTypes
        - status
        - version
        - createdAt
        - updatedAt
      type: object
    ProblemCause:
      properties:
        code:
          enum:
            - invalid_api_key
            - insufficient_scope
            - not_found
            - method_not_allowed
            - precondition_required
            - precondition_invalid
            - validation_failed
            - malformed_json
            - unsupported_content_type
            - request_body_too_large
            - idempotency_key_invalid
            - idempotency_key_reused
            - idempotency_request_in_progress
            - precondition_failed
            - cursor_invalid
            - rate_limit_exceeded
            - rate_limit_unavailable
            - api_dependency_unavailable
            - internal_error
            - invalid_error_response
            - token_not_found
            - holder_stats_not_found
            - market_time_range_invalid
            - token_index_unavailable
            - market_data_unavailable
            - identity_unavailable
            - staking_pool_not_found
            - presale_not_found
            - presale_participation_not_found
            - manifest_unavailable
            - prediction_wallet_mismatch
            - prediction_authorization_invalid
            - prediction_intent_not_found
            - prediction_round_not_found
            - prediction_not_found
            - prediction_token_not_enabled
            - prediction_round_not_open
            - prediction_wallet_not_verified
            - prediction_username_required
            - prediction_insufficient_balance
            - prediction_already_submitted
            - prediction_intent_expired
            - prediction_intent_consumed
            - prediction_exact_values_locked
            - prediction_price_out_of_range
            - prediction_balance_unavailable
            - operation_not_found
            - transaction_intent_not_found
            - transaction_intent_not_prepared
            - transaction_intent_expired
            - transaction_intent_version_conflict
            - transaction_intent_tampered
            - transaction_intent_wrong_signer
            - transaction_intent_invalid_signature
            - webhook_endpoint_not_found
            - webhook_delivery_not_found
            - webhook_delivery_not_replayable
            - webhook_endpoint_limit_reached
            - webhook_delivery_replay_limit_reached
            - webhook_url_disallowed
          type: string
        context:
          additionalProperties:
            oneOf:
              - maxLength: 1024
                type: string
              - type: number
              - type: boolean
              - type: 'null'
          type: object
        detail:
          maxLength: 2000
          minLength: 1
          type: string
        title:
          maxLength: 200
          minLength: 1
          type: string
      required:
        - code
        - title
        - detail
      type: object
    ProblemFieldError:
      properties:
        code:
          pattern: ^[a-z][a-z0-9_]*$
          type: string
        message:
          maxLength: 1024
          minLength: 1
          type: string
        path:
          maxLength: 512
          minLength: 1
          type: string
      required:
        - path
        - code
        - message
      type: object
  securitySchemes:
    BlankApiKey:
      bearerFormat: blank_live_… or blank_test_…
      description: >-
        Server-side scoped Blank API key. Never embed it in browser or mobile
        code.
      scheme: bearer
      type: http

````