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

# Listar eventos

> Los eventos del estudio de los últimos 30 días, del más nuevo al más viejo. Cada evento dice qué
cambió y el id del objeto, nunca sus datos: para ver cómo quedó, pide el objeto con su ruta.

Solo ves los eventos de los recursos que tu clave puede leer: `booking.*` necesita `bookings:read`,
`session.*` `sessions:read`, `client.*` `clients:read`, `credit_grant.*` `credits:read`,
`membership.*` `memberships:read`, `fee.*` `fees:read`, `payment.*` `payments:read` y `refund.*`
`refunds:read`. Pedir con `type` u `object_id` un recurso que tu clave no puede leer responde
`event_type_not_permitted`.

Para no perderte nada, consulta por ventanas de `created_at` que se solapen al menos 10 minutos y
descarta los `id` que ya procesaste: el orden es el de alta del evento, y un cambio de una operación
larga puede aparecer un poco después que otros más nuevos.

Paginada por cursor: pide `limit=100` y sigue `next_cursor`.

Solo para estudios: en una academia responde `wrong_vertical`. Un parámetro que la ruta no
declara responde `validation_failed` con `unknown_parameter`.




## OpenAPI

````yaml /estudios/openapi.yaml get /events
openapi: 3.1.0
info:
  title: API de Craqui
  version: '2026-12-01'
  summary: Conecta tu web o tu sistema a tu estudio o academia en Craqui.
  description: >
    API REST de Craqui. Cada clave pertenece a un solo negocio (un estudio o una
    academia) y todo lo

    que devuelve es de ese negocio.


    - **Autenticación:** `Authorization: Bearer <clave>`. Las claves se crean en
    Configuración →
      Integraciones. Una app de terceros usa, en lugar de una clave, el access token (`crq_oat_…`) que recibe
      cuando el propietario de un negocio la conecta (OAuth 2.1): vale para ese negocio y los permisos que el
      propietario aceptó. Una clave `crq_live_` usa los datos reales del negocio; una `crq_test_` usa su
      estudio de prueba: la misma configuración (sedes, clases, packs, planes) con clientes y
      reservas de ejemplo, que no le escribe a nadie. La URL es la misma: el entorno lo decide la
      clave. Todo objeto dice en `livemode` de cuál de los dos viene.
    - **Versión:** cada clave queda fijada a la versión vigente cuando se creó.
    El header
      `Craqui-Version` la sobrescribe por pedido, y la respuesta siempre dice cuál se usó.
    - **Errores:** `application/problem+json` (RFC 9457), con un `code` estable
    para programar y un
      `request_id` para buscar el pedido en tu panel.
    - **Montos:** enteros en `amount_cents` (siempre ×100) junto con la moneda
    ISO 4217.

    - **Fechas y horas:** instantes en RFC 3339 con el offset del negocio;
    fechas sin hora como
      `YYYY-MM-DD` en la fecha local del negocio.
  contact:
    name: Craqui
    url: https://craqui.com
servers:
  - url: https://api.craqui.com/v1
    description: Producción
security:
  - bearerAuth: []
tags:
  - name: business
    description: El negocio al que pertenece la clave (un estudio o una academia).
  - name: booking_policy
    description: Las reglas de reserva del estudio. Solo estudios.
  - name: centers
    description: Las sedes del estudio. Solo estudios.
  - name: rooms
    description: Los salones de cada sede. Solo estudios.
  - name: teachers
    description: Quienes dan clases en el estudio. Solo estudios.
  - name: courses
    description: Las disciplinas del estudio (Yoga, Pilates…). Solo estudios.
  - name: classes
    description: Las clases con su horario semanal. Solo estudios.
  - name: sessions
    description: El horario del estudio, sesión por sesión, con sus lugares. Solo estudios.
  - name: clients
    description: >-
      Los clientes del estudio, con el contacto separado en su propio permiso.
      Solo estudios.
  - name: bookings
    description: Las reservas de las sesiones. Solo estudios.
  - name: credit_packs
    description: Los packs de créditos que vende el estudio. Solo estudios.
  - name: membership_plans
    description: Los planes de membresía que vende el estudio. Solo estudios.
  - name: intro_offers
    description: Las ofertas de bienvenida que vende el estudio. Solo estudios.
  - name: credits
    description: Los créditos de los clientes, sus lotes y sus movimientos. Solo estudios.
  - name: memberships
    description: Las membresías de los clientes y sus congelamientos. Solo estudios.
  - name: fees
    description: Las cuotas que el estudio le cobra a cada cliente. Solo estudios.
  - name: payments
    description: Los pagos de las cuotas. Solo estudios.
  - name: refunds
    description: Los reembolsos de los pagos. Solo estudios.
  - name: events
    description: >
      Lo que cambió en el estudio en los últimos 30 días, para enterarte sin
      consultar cada lista. Solo

      estudios.
  - name: webhook_endpoints
    description: >
      Las URLs a las que Craqui le avisa cada vez que algo cambia en el estudio,
      firmado y con reintentos. Solo

      estudios y solo con una clave `crq_live_`.
paths:
  /events:
    get:
      tags:
        - events
      summary: Listar eventos
      description: >
        Los eventos del estudio de los últimos 30 días, del más nuevo al más
        viejo. Cada evento dice qué

        cambió y el id del objeto, nunca sus datos: para ver cómo quedó, pide el
        objeto con su ruta.


        Solo ves los eventos de los recursos que tu clave puede leer:
        `booking.*` necesita `bookings:read`,

        `session.*` `sessions:read`, `client.*` `clients:read`, `credit_grant.*`
        `credits:read`,

        `membership.*` `memberships:read`, `fee.*` `fees:read`, `payment.*`
        `payments:read` y `refund.*`

        `refunds:read`. Pedir con `type` u `object_id` un recurso que tu clave
        no puede leer responde

        `event_type_not_permitted`.


        Para no perderte nada, consulta por ventanas de `created_at` que se
        solapen al menos 10 minutos y

        descarta los `id` que ya procesaste: el orden es el de alta del evento,
        y un cambio de una operación

        larga puede aparecer un poco después que otros más nuevos.


        Paginada por cursor: pide `limit=100` y sigue `next_cursor`.


        Solo para estudios: en una academia responde `wrong_vertical`. Un
        parámetro que la ruta no

        declara responde `validation_failed` con `unknown_parameter`.
      operationId: listEvents
      parameters:
        - $ref: '#/components/parameters/CraquiVersion'
        - name: type
          in: query
          required: false
          description: >-
            Un tipo exacto (`booking.cancelled`) o todos los de un recurso
            (`booking.*`). Uno que no existe responde `validation_failed` con
            `event_type_unknown`.
          schema:
            type: string
            maxLength: 64
        - name: object_id
          in: query
          required: false
          description: >-
            Solo los eventos de este objeto, por su id público (`bkg_…`,
            `ses_…`, `cli_…`).
          schema:
            type: string
            maxLength: 64
        - name: created_at[gte]
          in: query
          required: false
          description: Solo los eventos desde este instante, incluido.
          schema:
            $ref: '#/components/schemas/Instant'
        - name: created_at[lte]
          in: query
          required: false
          description: Solo los eventos hasta este instante, incluido.
          schema:
            $ref: '#/components/schemas/Instant'
        - $ref: '#/components/parameters/Limit'
        - $ref: '#/components/parameters/StartingAfter'
      responses:
        '200':
          description: OK.
          headers:
            Request-Id:
              $ref: '#/components/headers/RequestId'
            Craqui-Version:
              $ref: '#/components/headers/CraquiVersion'
            RateLimit:
              $ref: '#/components/headers/RateLimit'
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimitPolicy'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EventList'
              example:
                object: list
                data:
                  - id: evt_79p14jhbsm8gaaj1bwvqa5jfg5
                    object: event
                    type: booking.attended
                    created_at: '2026-12-01T09:05:12-03:00'
                    livemode: true
                    data:
                      object_id: bkg_01j5cceh8fkntbjm406cvh2kwm
                      object_type: booking
                    previous_attributes:
                      status: confirmed
                  - id: evt_2yh1kwctjx8f58e1vvrn26jtfm
                    object: event
                    type: booking.waitlisted
                    created_at: '2026-11-30T21:14:50-03:00'
                    livemode: true
                    data:
                      object_id: bkg_01jhngfzx1pzdg0f74qtqz65z4
                      object_type: booking
                    previous_attributes: {}
                  - id: evt_5fkdf0bg0w9b7rdm990g1h6z8p
                    object: event
                    type: booking.created
                    created_at: '2026-11-29T20:47:03-03:00'
                    livemode: true
                    data:
                      object_id: bkg_01jbe9wj3870617xp1spzk0a7w
                      object_type: booking
                    previous_attributes: {}
                  - id: evt_63qzjb33kp9g3a440mjsmwqq10
                    object: event
                    type: payment.created
                    created_at: '2026-11-27T18:21:14-03:00'
                    livemode: true
                    data:
                      object_id: pay_01jtgmw7szee210a7q1nezmyyk
                      object_type: payment
                    previous_attributes: {}
                  - id: evt_7ydz49me0c8azrxyrdnyytv2nn
                    object: event
                    type: membership.renewed
                    created_at: '2026-11-14T00:00:04-03:00'
                    livemode: true
                    data:
                      object_id: mem_01j1q27t44qvr6v2s50cv4rbvq
                      object_type: membership
                    previous_attributes:
                      current_period_start: '2026-10-14T00:00:00-03:00'
                      current_period_end: '2026-11-14T00:00:00-03:00'
                has_more: false
                next_cursor: null
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '409':
          $ref: '#/components/responses/Conflict'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          $ref: '#/components/responses/InternalError'
      security:
        - bearerAuth: []
        - oauth2:
            - events:read
components:
  parameters:
    CraquiVersion:
      name: Craqui-Version
      in: header
      required: false
      description: >
        Versión de la API para este pedido (`YYYY-MM-DD`). Si no la mandas, se
        usa la versión fijada en

        la clave cuando se creó.
      schema:
        type: string
        pattern: ^\d{4}-\d{2}-\d{2}$
        examples:
          - '2026-12-01'
    Limit:
      name: limit
      in: query
      required: false
      description: Cuántos elementos traer, de 1 a 100.
      schema:
        type: integer
        minimum: 1
        maximum: 100
        default: 20
    StartingAfter:
      name: starting_after
      in: query
      required: false
      schema:
        type: string
      description: >
        El `next_cursor` de la página anterior. Sirve solo para la misma ruta
        con los mismos filtros: con

        otros, la respuesta es `invalid_cursor`.
  schemas:
    Instant:
      type: string
      format: date-time
      description: Instante en RFC 3339 con el offset del negocio en ese momento.
      examples:
        - '2026-12-02T19:00:00-03:00'
    EventList:
      allOf:
        - $ref: '#/components/schemas/List'
        - type: object
          properties:
            data:
              type: array
              items:
                $ref: '#/components/schemas/Event'
    List:
      type: object
      required:
        - object
        - data
        - has_more
        - next_cursor
      properties:
        object:
          type: string
          const: list
        data:
          type: array
          items: {}
        has_more:
          type: boolean
          description: Si hay más elementos después de esta página.
        next_cursor:
          type:
            - string
            - 'null'
          description: >-
            Pásalo en `starting_after` para pedir la página siguiente. `null` si
            no hay más.
    Event:
      type: object
      description: >
        Algo que cambió en tu estudio: una reserva, una sesión, un cliente, un
        pago. Trae qué cambió y el id del

        objeto, nunca sus datos: para ver cómo quedó, pide el objeto con su ruta
        (`GET /bookings/{id}`, por

        ejemplo) y el permiso de ese recurso. Un mismo evento puede llegarte más
        de una vez y no hay un orden

        garantizado entre eventos: usa `id` para no procesarlo dos veces.
      required:
        - id
        - object
        - type
        - created_at
        - livemode
        - data
        - previous_attributes
      properties:
        id:
          $ref: '#/components/schemas/EventId'
        object:
          type: string
          const: event
        type:
          type: string
          description: >
            Qué pasó, como `<recurso>.<cambio>`. La lista puede crecer: ignora
            un tipo que no conoces.


            - Clientes: `client.created`, `client.updated` (nombre, contacto o
            sede), `client.deactivated`,
              `client.reactivated`.
            - Reservas: `booking.created` (también al volver a reservar una
            reserva cancelada),
              `booking.cancelled`, `booking.waitlisted`, `booking.promoted` (de la lista de espera a la clase),
              `booking.attended`, `booking.no_show`, `booking.attendance_undone`.
            - Sesiones: `session.created`, `session.cancelled` (también por un
            cierre del estudio),
              `session.restored`, `session.deleted`, `session.rescheduled`, `session.teacher_changed`.
            - Créditos: `credit_grant.created`, `credit_grant.revoked`,
            `credit_grant.expired`.

            - Membresías: `membership.created`, `membership.activated`,
            `membership.renewed`,
              `membership.suspended`, `membership.cancellation_scheduled`, `membership.cancellation_undone`,
              `membership.ended`, `membership.frozen`, `membership.unfrozen`.
            - Cobros: `fee.created`, `fee.overdue`, `fee.paid`,
            `payment.created`, `refund.created`.


            Dos cambios iguales del mismo objeto en una misma operación dejan un
            solo evento.
          enum:
            - client.created
            - client.updated
            - client.deactivated
            - client.reactivated
            - booking.created
            - booking.cancelled
            - booking.waitlisted
            - booking.promoted
            - booking.attended
            - booking.no_show
            - booking.attendance_undone
            - session.created
            - session.cancelled
            - session.restored
            - session.deleted
            - session.rescheduled
            - session.teacher_changed
            - credit_grant.created
            - credit_grant.revoked
            - credit_grant.expired
            - membership.created
            - membership.activated
            - membership.renewed
            - membership.suspended
            - membership.cancellation_scheduled
            - membership.cancellation_undone
            - membership.ended
            - membership.frozen
            - membership.unfrozen
            - fee.created
            - fee.overdue
            - fee.paid
            - payment.created
            - refund.created
          x-extensible-enum: true
        created_at:
          $ref: '#/components/schemas/Instant'
        livemode:
          type: boolean
          description: >-
            `false` si el objeto es de tu estudio de prueba (claves
            `crq_test_`); `true` con claves `crq_live_`. Hoy tu estudio de
            prueba no genera eventos.
        data:
          $ref: '#/components/schemas/EventData'
        previous_attributes:
          type: object
          description: >
            Los valores públicos que el objeto tenía antes del cambio, solo los
            que cambiaron y tienen forma pública:

            `status` en reservas, clientes, sesiones, membresías y cuotas;
            `waitlist_position` en

            `booking.promoted`; `starts_at` y `ends_at` en
            `session.rescheduled`; `current_period_start` y

            `current_period_end` en `membership.renewed`. Vacío (`{}`) si no hay
            nada que contar. Nunca trae datos

            personales: `client.updated` no dice qué tenía antes.
          properties:
            status:
              type: string
              description: >-
                El estado anterior, con los mismos valores que el campo `status`
                del objeto.
            waitlist_position:
              type:
                - integer
                - 'null'
            starts_at:
              $ref: '#/components/schemas/Instant'
            ends_at:
              $ref: '#/components/schemas/Instant'
            current_period_start:
              $ref: '#/components/schemas/Instant'
            current_period_end:
              $ref: '#/components/schemas/Instant'
    Problem:
      type: object
      description: >
        Un error. Programa contra `code`, que no cambia; `title` y `detail` son
        para mostrarle a una

        persona y pueden cambiar de redacción.
      required:
        - type
        - title
        - status
        - code
        - request_id
      properties:
        type:
          type: string
          format: uri
          description: URL de la página de la documentación de este error.
          examples:
            - https://docs.craqui.com/errors/invalid_api_key
        title:
          type: string
          description: Resumen corto, en español.
          examples:
            - La clave no es válida
        status:
          type: integer
          description: El mismo código HTTP de la respuesta.
          examples:
            - 401
        code:
          type: string
          description: >
            Código estable del error. La lista puede crecer: trata un `code` que
            no conoces como un

            error genérico de su `status`.
          examples:
            - invalid_api_key
        detail:
          type: string
          description: Qué pasó y qué hacer, en español.
          examples:
            - >-
              Revisa que copiaste la clave completa, incluido el prefijo
              (crq_live_ o crq_test_).
        request_id:
          type: string
          pattern: ^req_[0-9a-hjkmnp-tv-z]{26}$
          description: >-
            Identificador del pedido. Búscalo en Configuración → Integraciones →
            Actividad de la API.
          examples:
            - req_01hzx8m4k2a7d9q3f5w6y8z0bc
        doc_url:
          type: string
          format: uri
          description: >-
            Igual a `type`, por compatibilidad con clientes que buscan este
            campo.
        required_scope:
          type: string
          description: >-
            Solo en `scope_required` y `event_type_not_permitted`. El permiso
            que le falta a la clave.
          examples:
            - business:read
        errors:
          type: array
          description: Solo en errores de validación. Un elemento por campo con problemas.
          items:
            $ref: '#/components/schemas/FieldError'
        current_price:
          $ref: '#/components/schemas/Money'
          description: >-
            Solo en `price_changed`. El precio de hoy, en centésimos y con su
            moneda.
        expected_amount:
          $ref: '#/components/schemas/Money'
          description: >-
            Solo en `amount_mismatch`. El saldo de hoy de la cuota, en
            centésimos y con su moneda.
        amount_at_stake:
          $ref: '#/components/schemas/Money'
          description: >-
            Solo en `advance_payment_choice_required`. Lo que falta cobrar del
            pago por adelantado.
        existing_membership_id:
          $ref: '#/components/schemas/MembershipId'
          description: >
            Solo en `active_membership_exists`, `membership_suspended`,
            `membership_paused` y `membership_scheduled` al

            asignar una membresía: la que el cliente ya tiene.
        booking_ids:
          type: array
          description: >-
            Solo en `bookings_in_freeze_window` y `bookings_changed`. Las
            reservas en esas fechas.
          items:
            $ref: '#/components/schemas/BookingId'
    EventId:
      type: string
      description: Id de un evento.
      pattern: ^evt_[0-7][0-9a-hjkmnp-tv-z]{25}$
      examples:
        - evt_79p14jhbsm8gaaj1bwvqa5jfg5
    EventData:
      type: object
      required:
        - object_id
        - object_type
      properties:
        object_id:
          type: string
          description: >-
            El id público del objeto, con el prefijo de su recurso (`bkg_…`,
            `ses_…`, `cli_…`).
          pattern: ^(cli|bkg|ses|cgr|mem|fee|pay|rfd)_[0-7][0-9a-hjkmnp-tv-z]{25}$
        object_type:
          type: string
          description: >-
            El recurso: `client`, `booking`, `session`, `credit_grant`,
            `membership`, `fee`, `payment` o `refund`. La lista puede crecer.
          enum:
            - client
            - booking
            - session
            - credit_grant
            - membership
            - fee
            - payment
            - refund
          x-extensible-enum: true
    FieldError:
      type: object
      required:
        - field
        - code
      properties:
        field:
          type: string
          description: El campo, como lo mandaste (por ejemplo `limit`).
          examples:
            - limit
        code:
          type: string
          description: Qué tiene mal el campo.
          examples:
            - invalid_limit
        detail:
          type: string
          description: Explicación en español.
    Money:
      type: object
      required:
        - amount_cents
        - currency
      properties:
        amount_cents:
          type: integer
          description: >
            El monto multiplicado por 100. `250000` con `UYU` es $ 2.500,00. Un
            entero: `250000.5` o `"250000"` es

            `validation_failed` (`250000.0` es el mismo número que `250000`).
          examples:
            - 250000
        currency:
          $ref: '#/components/schemas/CurrencyCode'
    MembershipId:
      type: string
      description: Id de una membresía de un cliente.
      pattern: ^mem_[0-7][0-9a-hjkmnp-tv-z]{25}$
      examples:
        - mem_01j1q27t44qvr6v2s50cv4rbvq
    BookingId:
      type: string
      description: Id de una reserva.
      pattern: ^bkg_[0-7][0-9a-hjkmnp-tv-z]{25}$
      examples:
        - bkg_01jx9eak0437zdf0yw0atg7g0r
    CurrencyCode:
      type: string
      description: Moneda ISO 4217, en mayúsculas.
      pattern: ^[A-Z]{3}$
      examples:
        - UYU
  headers:
    RequestId:
      description: Identificador del pedido. Aparece también en el cuerpo de los errores.
      schema:
        type: string
        pattern: ^req_[0-9a-hjkmnp-tv-z]{26}$
    CraquiVersion:
      description: La versión de la API con la que se respondió.
      schema:
        type: string
        pattern: ^\d{4}-\d{2}-\d{2}$
    RateLimit:
      description: >-
        Pedidos que quedan en la ventana actual y segundos hasta que se renueva
        (draft IETF httpapi-ratelimit-headers).
      schema:
        type: string
        examples:
          - '"read";r=97;t=42'
    RateLimitPolicy:
      description: Límite de la clave por ventana (draft IETF httpapi-ratelimit-headers).
      schema:
        type: string
        examples:
          - '"read";q=100;w=60'
    RetryAfter:
      description: Segundos que hay que esperar antes de reintentar.
      schema:
        type: integer
        minimum: 0
  responses:
    BadRequest:
      description: >
        El pedido está mal formado. Códigos posibles: `invalid_api_version`,
        `idempotency_key_required`,

        `validation_failed` (con un elemento de `errors` por parámetro:
        `unknown_parameter`,

        `invalid_prefix`, `invalid_id`, `invalid_date`, `invalid_boolean`,
        `invalid_enum`,

        `invalid_limit`, `duplicate_parameter`, `expand_not_supported`…) e
        `invalid_cursor` (un

        `starting_after` de otra búsqueda: repite la primera página con los
        mismos filtros). En las URLs de

        avisos, `webhook_url_invalid` (en `errors`, la causa: `not_https`,
        `port_not_allowed`,

        `credentials_in_url`, `ip_literal`, `internal_hostname`,
        `private_address`, `craqui_host` o `too_long`).

        Al cancelar una sesión, `notify_not_supported` (esa escritura no lleva
        `notify`: siempre avisa); también al

        revocar un pack y al congelar o descongelar una membresía (no le avisan
        nada al cliente). En las escrituras de

        plata, `fee_decision_required` y `current_fee_choice_required` (la API
        no decide sobre plata por ti).

        Un token en la URL o en un cuerpo de formulario responde
        `invalid_request`: va solo en el header

        `Authorization`. El detalle de un error nunca repite el valor que
        mandaste.
      headers:
        Request-Id:
          $ref: '#/components/headers/RequestId'
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/Problem'
    Unauthorized:
      description: >
        Falta la clave o no sirve. Códigos posibles: `missing_api_key`,
        `invalid_api_key`,

        `revoked_api_key`, `expired_api_key`, `legacy_api_key`. Con el token de
        una app: `invalid_access_token` (no

        es válido o venció: pide otro con el refresh token) y
        `app_connection_revoked` (el propietario desconectó la

        app); los dos llevan el header `WWW-Authenticate: Bearer
        error="invalid_token"`.
      headers:
        Request-Id:
          $ref: '#/components/headers/RequestId'
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/Problem'
          examples:
            revoked:
              value:
                type: https://docs.craqui.com/errors/revoked_api_key
                title: La clave fue revocada
                status: 401
                code: revoked_api_key
                detail: Crea una clave nueva en Configuración → Integraciones.
                request_id: req_01hzx8m4k2a7d9q3f5w6y8z0bc
    Forbidden:
      description: >
        La clave es válida pero no puede hacer esto. Códigos posibles:
        `scope_required`,

        `plan_required`, `api_key_suspended`, `browser_not_allowed`,
        `wrong_vertical`,

        `event_type_not_permitted` (eventos de un recurso que la clave no puede
        leer; `required_scope` dice cuál) y

        `write_access_disabled` (en una ruta que crea o cambia datos, si tu
        negocio no tiene habilitada la escritura por

        la API) y `money_writes_not_enabled` (en una ruta de packs, membresías o
        pagos, si tu negocio no tiene

        habilitadas las escrituras de plata). Con el token de una app, además:
        `app_suspended` (Craqui suspendió la

        app) y `app_connection_suspended` (quien conectó la app ya no es
        propietario del negocio).
      headers:
        Request-Id:
          $ref: '#/components/headers/RequestId'
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/Problem'
    Conflict:
      description: >
        Solo con una clave `crq_test_`: tu estudio de prueba no está listo.
        Código

        `sandbox_unavailable`. Restablece tus datos de prueba en Configuración →
        Integraciones y vuelve

        a intentar. Una clave de prueba nunca responde con los datos reales del
        negocio. En los pedidos que

        crean o modifican algo, también `idempotency_in_progress` (el mismo
        pedido todavía se está procesando) y,

        al crear una URL de avisos, `webhook_endpoint_limit_reached` (ya hay
        10). En una ruta que crea o cambia datos

        del estudio, además, sus reglas no dejan hacerlo: la descripción de cada
        ruta lista sus códigos.
      headers:
        Request-Id:
          $ref: '#/components/headers/RequestId'
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/Problem'
          examples:
            sandbox_unavailable:
              value:
                type: https://docs.craqui.com/errors/sandbox_unavailable
                title: Tu estudio de prueba no está listo
                status: 409
                code: sandbox_unavailable
                detail: >-
                  Restablece tus datos de prueba en Configuración →
                  Integraciones y vuelve a intentar.
                request_id: req_01hzx8m4k2a7d9q3f5w6y8z0bc
    TooManyRequests:
      description: >-
        Se pasó el límite de pedidos por minuto de la clave. Código
        `rate_limited`.
      headers:
        Request-Id:
          $ref: '#/components/headers/RequestId'
        Retry-After:
          $ref: '#/components/headers/RetryAfter'
        RateLimit:
          $ref: '#/components/headers/RateLimit'
        RateLimit-Policy:
          $ref: '#/components/headers/RateLimitPolicy'
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/Problem'
    InternalError:
      description: >-
        Falló algo de nuestro lado. Código `internal_error`. Reintenta; si
        sigue, escríbenos con el `request_id`.
      headers:
        Request-Id:
          $ref: '#/components/headers/RequestId'
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/Problem'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: crq_live_sk_… / crq_live_rk_…
      description: >
        Clave del negocio. `sk` es una clave completa (todo lo que el rol de
        quien la creó puede dar)

        y `rk` una restringida a los permisos que se eligieron al crearla. Solo
        se usa desde un

        servidor: un pedido desde un navegador se rechaza con
        `browser_not_allowed`.
    oauth2:
      type: oauth2
      description: >
        Una app de terceros conectada a un negocio por su propietario (OAuth
        2.1, Authorization Code con PKCE). El

        access token (`crq_oat_…`) vale 1 hora, va solo en el header
        `Authorization: Bearer` y es de un solo negocio.

        Una app nunca recibe `notifications:suppress` ni `webhooks:manage`. Ver
        https://docs.craqui.com/apps.
      flows:
        authorizationCode:
          authorizationUrl: https://www.craqui.com/oauth/authorize
          tokenUrl: https://api.craqui.com/oauth/token
          refreshUrl: https://api.craqui.com/oauth/token
          scopes:
            business:read: Ver los datos básicos del negocio (siempre incluido).
            centers:read: Ver las sedes.
            rooms:read: Ver los salones.
            teachers:read: Ver a quienes dan clases.
            courses:read: Ver las disciplinas.
            classes:read: Ver las clases y su horario.
            sessions:read: Ver el horario, sesión por sesión.
            sessions:write: Cancelar sesiones.
            clients:read: Ver los clientes.
            clients.pii:read: Ver el email y el teléfono de los clientes.
            clients:write: Crear, cambiar, dar de baja y reactivar clientes.
            bookings:read: Ver las reservas.
            bookings:write: Reservar, cancelar reservas y marcar asistencia.
            credits:read: Ver los créditos de los clientes.
            credits:write: Asignar y revocar packs de créditos.
            memberships:read: Ver las membresías.
            memberships:write: Asignar, cancelar, congelar y descongelar membresías.
            fees:read: Ver las cuotas.
            payments:read: Ver los pagos.
            refunds:read: Ver los reembolsos.
            payments:write: Registrar pagos.
            events:read: Ver la lista de cambios recientes.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.