> ## 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. # Cancelar una sesión > Cancela una sesión, igual que desde Craqui: se cancelan todas sus reservas (confirmadas y en lista de espera) y vuelven los créditos de las confirmadas. Nadie entra de la lista de espera, porque la sesión ya no se da. Se les avisa a quienes tenían reserva y a quienes iban a ir, por los canales que el estudio tenga encendidos, con el `reason` que mandes. Responde la sesión como queda, con `status: cancelled`. No admite `notify` (`400 notify_not_supported`): cancelar una sesión siempre avisa. Tu estudio de prueba no le avisa a nadie. Si la sesión ya estaba cancelada, responde `200` con la sesión y no cancela, devuelve ni avisa nada de nuevo. Con `dry_run=true` responde `200` con la vista previa: cuántas reservas se cancelarían y cuántos créditos volverían. Rechazos (`409`): `session_started` (por la API no se cancela una sesión que ya empezó: se corrige desde Craqui) y `session_on_vacation` (el estudio ya la suspendió por vacaciones o un feriado: sus reservas ya se cancelaron y se avisó a quienes iban a ir). Una sesión que no es de tu negocio, o de un workshop, responde `404 not_found`. Una escritura: lleva `Idempotency-Key` (salvo con `dry_run=true`), solo para estudios (en una academia responde `wrong_vertical`), y solo si tu negocio tiene habilitada la escritura por la API (`write_access_disabled` si no). Un campo que el cuerpo no declara responde `validation_failed` con `unknown_field`. Cuenta para el límite de escrituras (30 por minuto). ## OpenAPI ````yaml /estudios/openapi.yaml post /sessions/{id}/cancel 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 `. 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: /sessions/{id}/cancel: post: tags: - sessions summary: Cancelar una sesión description: > Cancela una sesión, igual que desde Craqui: se cancelan todas sus reservas (confirmadas y en lista de espera) y vuelven los créditos de las confirmadas. Nadie entra de la lista de espera, porque la sesión ya no se da. Se les avisa a quienes tenían reserva y a quienes iban a ir, por los canales que el estudio tenga encendidos, con el `reason` que mandes. Responde la sesión como queda, con `status: cancelled`. No admite `notify` (`400 notify_not_supported`): cancelar una sesión siempre avisa. Tu estudio de prueba no le avisa a nadie. Si la sesión ya estaba cancelada, responde `200` con la sesión y no cancela, devuelve ni avisa nada de nuevo. Con `dry_run=true` responde `200` con la vista previa: cuántas reservas se cancelarían y cuántos créditos volverían. Rechazos (`409`): `session_started` (por la API no se cancela una sesión que ya empezó: se corrige desde Craqui) y `session_on_vacation` (el estudio ya la suspendió por vacaciones o un feriado: sus reservas ya se cancelaron y se avisó a quienes iban a ir). Una sesión que no es de tu negocio, o de un workshop, responde `404 not_found`. Una escritura: lleva `Idempotency-Key` (salvo con `dry_run=true`), solo para estudios (en una academia responde `wrong_vertical`), y solo si tu negocio tiene habilitada la escritura por la API (`write_access_disabled` si no). Un campo que el cuerpo no declara responde `validation_failed` con `unknown_field`. Cuenta para el límite de escrituras (30 por minuto). operationId: cancelSession parameters: - $ref: '#/components/parameters/CraquiVersion' - $ref: '#/components/parameters/SessionIdPath' - $ref: '#/components/parameters/IdempotencyKey' - $ref: '#/components/parameters/DryRun' requestBody: required: false content: application/json: schema: $ref: '#/components/schemas/SessionCancelRequest' example: reason: La instructora está enferma. Te esperamos el jueves. responses: '200': description: >- La sesión como quedó, o con `dry_run=true` la vista previa (`object` dice cuál). headers: Request-Id: $ref: '#/components/headers/RequestId' Craqui-Version: $ref: '#/components/headers/CraquiVersion' RateLimit: $ref: '#/components/headers/RateLimit' RateLimit-Policy: $ref: '#/components/headers/RateLimitPolicy' Idempotent-Replayed: $ref: '#/components/headers/IdempotentReplayed' content: application/json: schema: oneOf: - $ref: '#/components/schemas/Session' - $ref: '#/components/schemas/PreviewSessionCancel' example: id: ses_01jnb07m4yxxe0s687jf750tkv object: session livemode: true class_id: cls_01jryg07jeazdbx61dnx96ckmv course_id: crs_01jff81dk7rxtacmye5nanfp0h center_id: ctr_01j65pdnq74qvnh0953pzvtczg room_id: room_01jhweg897s9npa0tasfgt6a65 teacher_id: tch_01jmwqh91chk154n8xwnaw5ynd starts_at: '2026-12-02T19:00:00-03:00' ends_at: '2026-12-02T20:00:00-03:00' local_date: '2026-12-02' local_start_time: '19:00' local_end_time: '20:00' time_zone: America/Montevideo status: cancelled capacity: 20 booked_count: 0 waitlist_count: 0 available_spots: 20 created_at: '2026-11-04T03:00:00-03:00' updated_at: '2026-12-01T09:12:44-03:00' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' '409': $ref: '#/components/responses/Conflict' '422': $ref: '#/components/responses/UnprocessableEntity' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/InternalError' security: - bearerAuth: [] - oauth2: - sessions:write 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' SessionIdPath: name: id in: path required: true description: El id de la sesión (`ses_…`). schema: $ref: '#/components/schemas/SessionId' IdempotencyKey: name: Idempotency-Key in: header required: false description: > Obligatorio en todo pedido que crea o cambia algo, salvo con `dry_run=true`. Un valor único por operación (por ejemplo un UUID). Si repites el pedido con la misma clave y el mismo cuerpo dentro de 24 horas, recibes la misma respuesta (con el header `Idempotent-Replayed: true`) sin que se repita el efecto, también la misma respuesta de error: para intentar de nuevo algo que se rechazó, usa una clave nueva. Con un `dry_run=true` la clave se ignora y no se guarda: el pedido real puede usar la misma. Pasadas las 24 horas, repetir una reserva con la misma clave y el mismo cuerpo sigue devolviendo la reserva que se hizo (como está ahora), y la misma clave con otro cuerpo responde `idempotency_key_reused`. schema: type: string minLength: 1 maxLength: 255 DryRun: name: dry_run in: query required: false description: > `true` para ver qué pasaría sin hacerlo: Craqui evalúa el pedido con las mismas reglas que el real y responde `200` con un objeto `preview`, sin escribir nada ni avisarle a nadie. Cuenta para el límite de escrituras. `false` (o sin el parámetro) hace el pedido real. Es el único parámetro de consulta de una escritura. schema: type: boolean schemas: SessionCancelRequest: type: object additionalProperties: false description: > El cuerpo es opcional. No lleva `notify`: cancelar una sesión siempre avisa a quienes iban a ir (`400 notify_not_supported`). properties: reason: type: - string - 'null' maxLength: 200 description: El motivo, en una frase. Les llega a las personas avisadas. Session: type: object description: > Una sesión: una fecha de una clase, con su horario, quién la da y sus lugares. Solo sesiones de clases: los workshops no están en esta versión. required: - id - object - livemode - class_id - course_id - center_id - room_id - teacher_id - starts_at - ends_at - local_date - local_start_time - local_end_time - time_zone - status - capacity - booked_count - waitlist_count - available_spots - created_at - updated_at properties: id: $ref: '#/components/schemas/SessionId' object: type: string const: session livemode: type: boolean description: >- `false` si el objeto es de tu estudio de prueba (claves `crq_test_`); `true` con claves `crq_live_`. class_id: $ref: '#/components/schemas/ClassId' course_id: $ref: '#/components/schemas/CourseId' center_id: oneOf: - $ref: '#/components/schemas/CenterId' - type: 'null' room_id: description: El salón de esta sesión, si tiene uno asignado. oneOf: - $ref: '#/components/schemas/RoomId' - type: 'null' teacher_id: description: > Quien da esta sesión, con la suplencia aplicada (igual que el calendario del estudio). `null` si no tiene instructor asignado. oneOf: - $ref: '#/components/schemas/TeacherId' - type: 'null' starts_at: $ref: '#/components/schemas/Instant' description: > El inicio, con el offset del estudio en ese momento. Una hora local que no existe por el cambio de horario (por ejemplo 00:30 la noche en que se adelanta el reloj) se corre una hora, igual que al reservar: en ese caso `starts_at` y `local_start_time` no coinciden. ends_at: $ref: '#/components/schemas/Instant' description: El fin. Una clase que cruza la medianoche termina al día siguiente. local_date: $ref: '#/components/schemas/LocalDate' local_start_time: $ref: '#/components/schemas/LocalTime' local_end_time: $ref: '#/components/schemas/LocalTime' time_zone: type: - string - 'null' description: >- La zona horaria del estudio (IANA). `null` si el estudio no eligió una; los instantes salen en `+00:00`. examples: - America/Montevideo status: type: string description: > `scheduled`, `cancelled` (el estudio la canceló) o `studio_closed` (el estudio cerró ese día). La lista puede crecer: trata un valor que no conoces como una sesión que no se da. enum: - scheduled - cancelled - studio_closed x-extensible-enum: true capacity: type: - integer - 'null' description: El cupo de la sesión. `null` si la clase no tiene cupo. booked_count: type: integer description: > Los lugares tomados: reservas confirmadas, asistidas y ausentes hasta que la sesión empieza. Es la misma cuenta que usa Craqui al reservar. minimum: 0 waitlist_count: type: integer description: Cuántas personas esperan en la lista de espera. minimum: 0 available_spots: type: - integer - 'null' description: >- `capacity - booked_count`, nunca menos de 0. `null` si la clase no tiene cupo. minimum: 0 created_at: $ref: '#/components/schemas/Instant' updated_at: $ref: '#/components/schemas/Instant' PreviewSessionCancel: type: object description: > Lo que haría cancelar una sesión, sin hacerlo. Craqui la evalúa con las mismas reglas que el pedido real: si el real se rechazaría, la vista previa responde el mismo error. Entre la vista previa y el pedido real alguien puede reservar o cancelar, y entonces el real cancela y devuelve lo que haya en ese momento. required: - object - livemode - action - result - effects - warnings - summary properties: object: type: string const: preview livemode: type: boolean description: >- `false` si la vista previa es de tu estudio de prueba (claves `crq_test_`); `true` con claves `crq_live_`. action: type: string description: '`session.cancel`. La lista puede crecer.' enum: - session.cancel x-extensible-enum: true result: $ref: '#/components/schemas/Session' effects: $ref: '#/components/schemas/PreviewSessionCancelEffects' warnings: type: array description: >- `no_change` (la sesión ya está cancelada: el pedido real no cambia nada ni avisa). La lista puede crecer. items: type: string enum: - no_change x-extensible-enum: true summary: type: string description: >- Lo mismo en una frase en español, para mostrarle a una persona. No nombra a nadie. SessionId: type: string description: Id de una sesión (una fecha de una clase). pattern: ^ses_[0-7][0-9a-hjkmnp-tv-z]{25}$ examples: - ses_01jnb07m4yxxe0s687jf750tkv ClassId: type: string description: Id de una clase (el grupo con su horario semanal). pattern: ^cls_[0-7][0-9a-hjkmnp-tv-z]{25}$ examples: - cls_01jryg07jeazdbx61dnx96ckmv CourseId: type: string description: Id de una disciplina. pattern: ^crs_[0-7][0-9a-hjkmnp-tv-z]{25}$ examples: - crs_01jff81dk7rxtacmye5nanfp0h CenterId: type: string description: Id de una sede. pattern: ^ctr_[0-7][0-9a-hjkmnp-tv-z]{25}$ examples: - ctr_01j65pdnq74qvnh0953pzvtczg RoomId: type: string description: Id de un salón. pattern: ^room_[0-7][0-9a-hjkmnp-tv-z]{25}$ examples: - room_01jhweg897s9npa0tasfgt6a65 TeacherId: type: string description: Id de un instructor. pattern: ^tch_[0-7][0-9a-hjkmnp-tv-z]{25}$ examples: - tch_01jmwqh91chk154n8xwnaw5ynd 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' LocalDate: type: string format: date description: Fecha local del negocio, `YYYY-MM-DD`. pattern: ^\d{4}-\d{2}-\d{2}$ examples: - '2026-12-02' LocalTime: type: string description: Hora local del negocio, `HH:MM` (24 horas). pattern: ^\d{2}:\d{2}$ examples: - '19:00' PreviewSessionCancelEffects: type: object description: Lo que cancelar la sesión les haría a sus reservas y a quién avisaría. required: - bookings_cancelled - credits_refunded - notifies_people properties: bookings_cancelled: type: integer minimum: 0 description: Las reservas que se cancelarían, confirmadas y en lista de espera. credits_refunded: type: integer minimum: 0 description: >- Los créditos que volverían a los clientes (los de las reservas confirmadas). notifies_people: type: boolean description: > Si alguien recibiría un aviso: quienes tenían reserva, las personas de la clase y el equipo que la da, por los canales que el estudio tenga encendidos. `false` en tu estudio de prueba. 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' 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' IdempotentReplayed: description: >- `true` cuando la respuesta es la guardada de un pedido anterior con la misma `Idempotency-Key`. schema: type: string enum: - 'true' 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' NotFound: description: >- No existe, o no es de tu negocio. Código `not_found` o `route_not_found`. 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 UnprocessableEntity: description: > El pedido se entendió pero no se puede aplicar así. Códigos posibles: `idempotency_key_reused` (esa `Idempotency-Key` ya se usó con otro pedido: genera una nueva), `sandbox_contact_not_allowed` y `sandbox_account_reserved` (en tu estudio de prueba, un contacto que no es ficticio). En las escrituras de plata, además: `currency_mismatch`, `fee_decision_mismatch`, `fee_action_not_available`, `start_option_not_applicable` y `paid_on_out_of_range`. headers: Request-Id: $ref: '#/components/headers/RequestId' content: application/problem+json: schema: $ref: '#/components/schemas/Problem' 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.