API v1 de Be CRM

Respuesta 200 · { data }

Errores

• 400 `invalid_request`: Petición inválida (cuerpo, parámetros o consulta).
• 401 `unauthorized`: Falta la clave, no existe, está revocada o caducó.
• 403 `insufficient_scope`: La clave no tiene el alcance que exige la ruta.
• 429 `rate_limited`: Demasiadas llamadas (límite por clave y minuto). Ver `Retry-After`.
• 500 `internal`: Error interno.

Parámetros

• emailconsulta · string (email)
• tagconsulta · string
• ownerEmailconsulta · string (email)
• updatedSinceconsulta · string (date-time)

  Solo contactos con `updatedAt` posterior (no se combina con otros filtros).

• limitconsulta · string

  Elementos por página (1–100, por defecto 50).

• cursorconsulta · string

  `nextCursor` de la página anterior (opaco).

Respuesta 200 · { data: [ … ], nextCursor }

Errores

• 400 `invalid_request`: Petición inválida (cuerpo, parámetros o consulta).
• 401 `unauthorized`: Falta la clave, no existe, está revocada o caducó.
• 402 `contact_limit_exceeded`: Límite de contactos del plan superado: el workspace está bloqueado hasta subir de plan o de tramo (reintentar no lo arregla).
• 403 `insufficient_scope`: La clave no tiene el alcance que exige la ruta.
• 429 `rate_limited`: Demasiadas llamadas (límite por clave y minuto). Ver `Retry-After`.
• 500 `internal`: Error interno.

Parámetros

• Idempotency-Keycabecera · string

  Clave única por operación (≤ 255 caracteres). Repetir la misma petición devuelve la misma respuesta durante 24 h; con otro cuerpo, 422.

Cuerpo

Respuesta 201 · { data }

Errores

• 400 `invalid_request`: Petición inválida (cuerpo, parámetros o consulta).
• 401 `unauthorized`: Falta la clave, no existe, está revocada o caducó.
• 402 `contact_limit_exceeded`: Límite de contactos del plan superado: el workspace está bloqueado hasta subir de plan o de tramo (reintentar no lo arregla).
• 403 `insufficient_scope`: La clave no tiene el alcance que exige la ruta.
• 409 `conflict`: Conflicto con el estado actual (p. ej. ya existe). `idempotency_in_progress`: Otra petición con la misma Idempotency-Key se está procesando.
• 422 `idempotency_key_reused`: La Idempotency-Key ya se usó con otra petición.
• 429 `rate_limited`: Demasiadas llamadas (límite por clave y minuto). Ver `Retry-After`.
• 500 `internal`: Error interno.

Parámetros

• Idempotency-Keycabecera · string

  Clave única por operación (≤ 255 caracteres). Repetir la misma petición devuelve la misma respuesta durante 24 h; con otro cuerpo, 422.

Cuerpo

Respuesta 200 · { data }

Errores

• 400 `invalid_request`: Petición inválida (cuerpo, parámetros o consulta).
• 401 `unauthorized`: Falta la clave, no existe, está revocada o caducó.
• 402 `contact_limit_exceeded`: Límite de contactos del plan superado: el workspace está bloqueado hasta subir de plan o de tramo (reintentar no lo arregla).
• 403 `insufficient_scope`: La clave no tiene el alcance que exige la ruta.
• 409 `idempotency_in_progress`: Otra petición con la misma Idempotency-Key se está procesando.
• 422 `idempotency_key_reused`: La Idempotency-Key ya se usó con otra petición.
• 429 `rate_limited`: Demasiadas llamadas (límite por clave y minuto). Ver `Retry-After`.
• 500 `internal`: Error interno.

Parámetros

• idruta · stringobligatorio

Respuesta 200 · { data }

Errores

• 400 `invalid_request`: Petición inválida (cuerpo, parámetros o consulta).
• 401 `unauthorized`: Falta la clave, no existe, está revocada o caducó.
• 403 `insufficient_scope`: La clave no tiene el alcance que exige la ruta.
• 404 `not_found`: No existe (o no es de este workspace).
• 429 `rate_limited`: Demasiadas llamadas (límite por clave y minuto). Ver `Retry-After`.
• 500 `internal`: Error interno.

Parámetros

• idruta · stringobligatorio
• Idempotency-Keycabecera · string

  Clave única por operación (≤ 255 caracteres). Repetir la misma petición devuelve la misma respuesta durante 24 h; con otro cuerpo, 422.

Cuerpo

Respuesta 200 · { data }

Errores

• 400 `invalid_request`: Petición inválida (cuerpo, parámetros o consulta).
• 401 `unauthorized`: Falta la clave, no existe, está revocada o caducó.
• 403 `insufficient_scope`: La clave no tiene el alcance que exige la ruta.
• 404 `not_found`: No existe (o no es de este workspace).
• 409 `conflict`: Conflicto con el estado actual (p. ej. ya existe). `idempotency_in_progress`: Otra petición con la misma Idempotency-Key se está procesando.
• 422 `idempotency_key_reused`: La Idempotency-Key ya se usó con otra petición.
• 429 `rate_limited`: Demasiadas llamadas (límite por clave y minuto). Ver `Retry-After`.
• 500 `internal`: Error interno.

Parámetros

• idruta · stringobligatorio
• Idempotency-Keycabecera · string

  Clave única por operación (≤ 255 caracteres). Repetir la misma petición devuelve la misma respuesta durante 24 h; con otro cuerpo, 422.

Respuesta 200 · { data }

Errores

• 400 `invalid_request`: Petición inválida (cuerpo, parámetros o consulta).
• 401 `unauthorized`: Falta la clave, no existe, está revocada o caducó.
• 403 `insufficient_scope`: La clave no tiene el alcance que exige la ruta.
• 404 `not_found`: No existe (o no es de este workspace).
• 409 `idempotency_in_progress`: Otra petición con la misma Idempotency-Key se está procesando.
• 422 `idempotency_key_reused`: La Idempotency-Key ya se usó con otra petición.
• 429 `rate_limited`: Demasiadas llamadas (límite por clave y minuto). Ver `Retry-After`.
• 500 `internal`: Error interno.

Parámetros

• idruta · stringobligatorio
• Idempotency-Keycabecera · string

  Clave única por operación (≤ 255 caracteres). Repetir la misma petición devuelve la misma respuesta durante 24 h; con otro cuerpo, 422.

Cuerpo

Respuesta 200 · { data }

Errores

• 400 `invalid_request`: Petición inválida (cuerpo, parámetros o consulta).
• 401 `unauthorized`: Falta la clave, no existe, está revocada o caducó.
• 403 `insufficient_scope`: La clave no tiene el alcance que exige la ruta.
• 404 `not_found`: No existe (o no es de este workspace).
• 409 `idempotency_in_progress`: Otra petición con la misma Idempotency-Key se está procesando.
• 422 `idempotency_key_reused`: La Idempotency-Key ya se usó con otra petición.
• 429 `rate_limited`: Demasiadas llamadas (límite por clave y minuto). Ver `Retry-After`.
• 500 `internal`: Error interno.

Parámetros

• idruta · stringobligatorio
• limitconsulta · string

  Elementos por página (1–100, por defecto 50).

• cursorconsulta · string

  `nextCursor` de la página anterior (opaco).

Respuesta 200 · { data: [ … ], nextCursor }

Errores

• 400 `invalid_request`: Petición inválida (cuerpo, parámetros o consulta).
• 401 `unauthorized`: Falta la clave, no existe, está revocada o caducó.
• 403 `insufficient_scope`: La clave no tiene el alcance que exige la ruta.
• 404 `not_found`: No existe (o no es de este workspace).
• 429 `rate_limited`: Demasiadas llamadas (límite por clave y minuto). Ver `Retry-After`.
• 500 `internal`: Error interno.

Parámetros

• limitconsulta · string

  Elementos por página (1–100, por defecto 50).

• cursorconsulta · string

  `nextCursor` de la página anterior (opaco).

Respuesta 200 · { data: [ … ], nextCursor }

Errores

• 400 `invalid_request`: Petición inválida (cuerpo, parámetros o consulta).
• 401 `unauthorized`: Falta la clave, no existe, está revocada o caducó.
• 403 `insufficient_scope`: La clave no tiene el alcance que exige la ruta.
• 429 `rate_limited`: Demasiadas llamadas (límite por clave y minuto). Ver `Retry-After`.
• 500 `internal`: Error interno.

Parámetros

• Idempotency-Keycabecera · string

  Clave única por operación (≤ 255 caracteres). Repetir la misma petición devuelve la misma respuesta durante 24 h; con otro cuerpo, 422.

Cuerpo

Respuesta 201 · { data }

Errores

• 400 `invalid_request`: Petición inválida (cuerpo, parámetros o consulta).
• 401 `unauthorized`: Falta la clave, no existe, está revocada o caducó.
• 403 `insufficient_scope`: La clave no tiene el alcance que exige la ruta.
• 409 `idempotency_in_progress`: Otra petición con la misma Idempotency-Key se está procesando.
• 422 `idempotency_key_reused`: La Idempotency-Key ya se usó con otra petición.
• 429 `rate_limited`: Demasiadas llamadas (límite por clave y minuto). Ver `Retry-After`.
• 500 `internal`: Error interno.

Parámetros

• Idempotency-Keycabecera · string

  Clave única por operación (≤ 255 caracteres). Repetir la misma petición devuelve la misma respuesta durante 24 h; con otro cuerpo, 422.

Cuerpo

Respuesta 202 · { data }

Errores

• 400 `invalid_request`: Petición inválida (cuerpo, parámetros o consulta).
• 401 `unauthorized`: Falta la clave, no existe, está revocada o caducó.
• 402 `contact_limit_exceeded`: Límite de contactos del plan superado: el workspace está bloqueado hasta subir de plan o de tramo (reintentar no lo arregla). `quota_exceeded`: Cuota mensual del plan agotada: reintentar no lo arregla.
• 403 `insufficient_scope`: La clave no tiene el alcance que exige la ruta. `forbidden`: Operación no permitida.
• 404 `not_found`: No existe (o no es de este workspace).
• 409 `conflict`: Conflicto con el estado actual (p. ej. ya existe). `idempotency_in_progress`: Otra petición con la misma Idempotency-Key se está procesando.
• 422 `idempotency_key_reused`: La Idempotency-Key ya se usó con otra petición.
• 429 `rate_limited`: Demasiadas llamadas (límite por clave y minuto). Ver `Retry-After`.
• 500 `internal`: Error interno.
• 503 `unavailable`: Servicio no disponible temporalmente.

Parámetros

• idruta · stringobligatorio

Respuesta 200 · { data }

Errores

• 400 `invalid_request`: Petición inválida (cuerpo, parámetros o consulta).
• 401 `unauthorized`: Falta la clave, no existe, está revocada o caducó.
• 403 `insufficient_scope`: La clave no tiene el alcance que exige la ruta.
• 404 `not_found`: No existe (o no es de este workspace).
• 429 `rate_limited`: Demasiadas llamadas (límite por clave y minuto). Ver `Retry-After`.
• 500 `internal`: Error interno.

Parámetros

• leadIdconsulta · string

  Negocios de un contacto (no se combina con los demás filtros).

• pipelineIdconsulta · string
• statusconsulta · "open" | "won" | "lost"
• ownerEmailconsulta · string (email)
• limitconsulta · string

  Elementos por página (1–100, por defecto 50).

• cursorconsulta · string

  `nextCursor` de la página anterior (opaco).

Respuesta 200 · { data: [ … ], nextCursor }

Errores

• 400 `invalid_request`: Petición inválida (cuerpo, parámetros o consulta).
• 401 `unauthorized`: Falta la clave, no existe, está revocada o caducó.
• 402 `contact_limit_exceeded`: Límite de contactos del plan superado: el workspace está bloqueado hasta subir de plan o de tramo (reintentar no lo arregla).
• 403 `insufficient_scope`: La clave no tiene el alcance que exige la ruta. `feature_disabled`: La función está desactivada en el workspace.
• 429 `rate_limited`: Demasiadas llamadas (límite por clave y minuto). Ver `Retry-After`.
• 500 `internal`: Error interno.

Parámetros

• Idempotency-Keycabecera · string

  Clave única por operación (≤ 255 caracteres). Repetir la misma petición devuelve la misma respuesta durante 24 h; con otro cuerpo, 422.

Cuerpo

Respuesta 201 · { data }

Errores

• 400 `invalid_request`: Petición inválida (cuerpo, parámetros o consulta).
• 401 `unauthorized`: Falta la clave, no existe, está revocada o caducó.
• 403 `insufficient_scope`: La clave no tiene el alcance que exige la ruta. `feature_disabled`: La función está desactivada en el workspace.
• 404 `not_found`: No existe (o no es de este workspace).
• 409 `invalid_state`: Operación no válida en el estado actual. `idempotency_in_progress`: Otra petición con la misma Idempotency-Key se está procesando.
• 422 `idempotency_key_reused`: La Idempotency-Key ya se usó con otra petición.
• 429 `rate_limited`: Demasiadas llamadas (límite por clave y minuto). Ver `Retry-After`.
• 500 `internal`: Error interno.

Parámetros

• idruta · stringobligatorio

Respuesta 200 · { data }

Errores

• 400 `invalid_request`: Petición inválida (cuerpo, parámetros o consulta).
• 401 `unauthorized`: Falta la clave, no existe, está revocada o caducó.
• 403 `insufficient_scope`: La clave no tiene el alcance que exige la ruta. `feature_disabled`: La función está desactivada en el workspace.
• 404 `not_found`: No existe (o no es de este workspace).
• 429 `rate_limited`: Demasiadas llamadas (límite por clave y minuto). Ver `Retry-After`.
• 500 `internal`: Error interno.

Parámetros

• idruta · stringobligatorio
• Idempotency-Keycabecera · string

  Clave única por operación (≤ 255 caracteres). Repetir la misma petición devuelve la misma respuesta durante 24 h; con otro cuerpo, 422.

Cuerpo

Respuesta 200 · { data }

Errores

• 400 `invalid_request`: Petición inválida (cuerpo, parámetros o consulta).
• 401 `unauthorized`: Falta la clave, no existe, está revocada o caducó.
• 403 `insufficient_scope`: La clave no tiene el alcance que exige la ruta. `feature_disabled`: La función está desactivada en el workspace.
• 404 `not_found`: No existe (o no es de este workspace).
• 409 `rev_mismatch`: Otro cambio llegó antes (`expectedRev` desactualizado). `idempotency_in_progress`: Otra petición con la misma Idempotency-Key se está procesando.
• 422 `idempotency_key_reused`: La Idempotency-Key ya se usó con otra petición.
• 429 `rate_limited`: Demasiadas llamadas (límite por clave y minuto). Ver `Retry-After`.
• 500 `internal`: Error interno.

Parámetros

• idruta · stringobligatorio
• Idempotency-Keycabecera · string

  Clave única por operación (≤ 255 caracteres). Repetir la misma petición devuelve la misma respuesta durante 24 h; con otro cuerpo, 422.

Cuerpo

Respuesta 200 · { data }

Errores

• 400 `invalid_request`: Petición inválida (cuerpo, parámetros o consulta).
• 401 `unauthorized`: Falta la clave, no existe, está revocada o caducó.
• 403 `insufficient_scope`: La clave no tiene el alcance que exige la ruta. `feature_disabled`: La función está desactivada en el workspace.
• 404 `not_found`: No existe (o no es de este workspace).
• 409 `rev_mismatch`: Otro cambio llegó antes (`expectedRev` desactualizado). `invalid_state`: Operación no válida en el estado actual. `idempotency_in_progress`: Otra petición con la misma Idempotency-Key se está procesando.
• 422 `idempotency_key_reused`: La Idempotency-Key ya se usó con otra petición.
• 429 `rate_limited`: Demasiadas llamadas (límite por clave y minuto). Ver `Retry-After`.
• 500 `internal`: Error interno.

Parámetros

• idruta · stringobligatorio
• Idempotency-Keycabecera · string

  Clave única por operación (≤ 255 caracteres). Repetir la misma petición devuelve la misma respuesta durante 24 h; con otro cuerpo, 422.

Cuerpo

Respuesta 200 · { data }

Errores

• 400 `invalid_request`: Petición inválida (cuerpo, parámetros o consulta).
• 401 `unauthorized`: Falta la clave, no existe, está revocada o caducó.
• 403 `insufficient_scope`: La clave no tiene el alcance que exige la ruta. `feature_disabled`: La función está desactivada en el workspace.
• 404 `not_found`: No existe (o no es de este workspace).
• 409 `rev_mismatch`: Otro cambio llegó antes (`expectedRev` desactualizado). `invalid_state`: Operación no válida en el estado actual. `idempotency_in_progress`: Otra petición con la misma Idempotency-Key se está procesando.
• 422 `idempotency_key_reused`: La Idempotency-Key ya se usó con otra petición.
• 429 `rate_limited`: Demasiadas llamadas (límite por clave y minuto). Ver `Retry-After`.
• 500 `internal`: Error interno.

Parámetros

• idruta · stringobligatorio
• Idempotency-Keycabecera · string

  Clave única por operación (≤ 255 caracteres). Repetir la misma petición devuelve la misma respuesta durante 24 h; con otro cuerpo, 422.

Cuerpo

Respuesta 200 · { data }

Errores

• 400 `invalid_request`: Petición inválida (cuerpo, parámetros o consulta).
• 401 `unauthorized`: Falta la clave, no existe, está revocada o caducó.
• 403 `insufficient_scope`: La clave no tiene el alcance que exige la ruta. `feature_disabled`: La función está desactivada en el workspace.
• 404 `not_found`: No existe (o no es de este workspace).
• 409 `rev_mismatch`: Otro cambio llegó antes (`expectedRev` desactualizado). `invalid_state`: Operación no válida en el estado actual. `idempotency_in_progress`: Otra petición con la misma Idempotency-Key se está procesando.
• 422 `idempotency_key_reused`: La Idempotency-Key ya se usó con otra petición.
• 429 `rate_limited`: Demasiadas llamadas (límite por clave y minuto). Ver `Retry-After`.
• 500 `internal`: Error interno.

Respuesta 200 · { data: [ … ], nextCursor }

Errores

• 400 `invalid_request`: Petición inválida (cuerpo, parámetros o consulta).
• 401 `unauthorized`: Falta la clave, no existe, está revocada o caducó.
• 403 `insufficient_scope`: La clave no tiene el alcance que exige la ruta. `feature_disabled`: La función está desactivada en el workspace.
• 429 `rate_limited`: Demasiadas llamadas (límite por clave y minuto). Ver `Retry-After`.
• 500 `internal`: Error interno.

Parámetros

• leadIdconsulta · string
• dealIdconsulta · string
• limitconsulta · string

  Elementos por página (1–100, por defecto 50).

• cursorconsulta · string

  `nextCursor` de la página anterior (opaco).

Respuesta 200 · { data: [ … ], nextCursor }

Errores

• 400 `invalid_request`: Petición inválida (cuerpo, parámetros o consulta).
• 401 `unauthorized`: Falta la clave, no existe, está revocada o caducó.
• 403 `insufficient_scope`: La clave no tiene el alcance que exige la ruta. `feature_disabled`: La función está desactivada en el workspace.
• 429 `rate_limited`: Demasiadas llamadas (límite por clave y minuto). Ver `Retry-After`.
• 500 `internal`: Error interno.

Parámetros

• Idempotency-Keycabecera · string

  Clave única por operación (≤ 255 caracteres). Repetir la misma petición devuelve la misma respuesta durante 24 h; con otro cuerpo, 422.

Cuerpo

Respuesta 201 · { data }

Errores

• 400 `invalid_request`: Petición inválida (cuerpo, parámetros o consulta).
• 401 `unauthorized`: Falta la clave, no existe, está revocada o caducó.
• 403 `insufficient_scope`: La clave no tiene el alcance que exige la ruta. `feature_disabled`: La función está desactivada en el workspace.
• 404 `not_found`: No existe (o no es de este workspace).
• 409 `idempotency_in_progress`: Otra petición con la misma Idempotency-Key se está procesando.
• 422 `idempotency_key_reused`: La Idempotency-Key ya se usó con otra petición.
• 429 `rate_limited`: Demasiadas llamadas (límite por clave y minuto). Ver `Retry-After`.
• 500 `internal`: Error interno.

Parámetros

• leadIdconsulta · string

  Tareas de un contacto.

• assignedToEmailconsulta · string (email)
• statusconsulta · "open" | "done"

  Sin él, todas por fecha de vencimiento.

• limitconsulta · string

  Elementos por página (1–100, por defecto 50).

• cursorconsulta · string

  `nextCursor` de la página anterior (opaco).

Respuesta 200 · { data: [ … ], nextCursor }

Errores

• 400 `invalid_request`: Petición inválida (cuerpo, parámetros o consulta).
• 401 `unauthorized`: Falta la clave, no existe, está revocada o caducó.
• 403 `insufficient_scope`: La clave no tiene el alcance que exige la ruta.
• 404 `not_found`: No existe (o no es de este workspace).
• 429 `rate_limited`: Demasiadas llamadas (límite por clave y minuto). Ver `Retry-After`.
• 500 `internal`: Error interno.

Parámetros

• idruta · stringobligatorio
• taskIdruta · stringobligatorio
• Idempotency-Keycabecera · string

  Clave única por operación (≤ 255 caracteres). Repetir la misma petición devuelve la misma respuesta durante 24 h; con otro cuerpo, 422.

Cuerpo

Respuesta 200 · { data }

Errores

• 400 `invalid_request`: Petición inválida (cuerpo, parámetros o consulta).
• 401 `unauthorized`: Falta la clave, no existe, está revocada o caducó.
• 403 `insufficient_scope`: La clave no tiene el alcance que exige la ruta.
• 404 `not_found`: No existe (o no es de este workspace).
• 409 `idempotency_in_progress`: Otra petición con la misma Idempotency-Key se está procesando.
• 422 `idempotency_key_reused`: La Idempotency-Key ya se usó con otra petición.
• 429 `rate_limited`: Demasiadas llamadas (límite por clave y minuto). Ver `Retry-After`.
• 500 `internal`: Error interno.

Respuesta 200 · { data: [ … ], nextCursor }

Errores

• 400 `invalid_request`: Petición inválida (cuerpo, parámetros o consulta).
• 401 `unauthorized`: Falta la clave, no existe, está revocada o caducó.
• 403 `insufficient_scope`: La clave no tiene el alcance que exige la ruta.
• 429 `rate_limited`: Demasiadas llamadas (límite por clave y minuto). Ver `Retry-After`.
• 500 `internal`: Error interno.

Parámetros

• Idempotency-Keycabecera · string

  Clave única por operación (≤ 255 caracteres). Repetir la misma petición devuelve la misma respuesta durante 24 h; con otro cuerpo, 422.

Cuerpo

Respuesta 201 · { data }

Errores

• 400 `invalid_request`: Petición inválida (cuerpo, parámetros o consulta).
• 401 `unauthorized`: Falta la clave, no existe, está revocada o caducó.
• 402 `quota_exceeded`: Cuota mensual del plan agotada: reintentar no lo arregla. `contact_limit_exceeded`: Límite de contactos del plan superado: el workspace está bloqueado hasta subir de plan o de tramo (reintentar no lo arregla).
• 403 `insufficient_scope`: La clave no tiene el alcance que exige la ruta. `feature_disabled`: La función está desactivada en el workspace.
• 409 `invalid_state`: Operación no válida en el estado actual. `conflict`: Conflicto con el estado actual (p. ej. ya existe). `unknown_outcome`: El proveedor no respondió y el mensaje pudo salir. No reintentes con otra Idempotency-Key: podría duplicarse. `idempotency_in_progress`: Otra petición con la misma Idempotency-Key se está procesando.
• 422 `idempotency_key_reused`: La Idempotency-Key ya se usó con otra petición.
• 429 `rate_limited`: Demasiadas llamadas (límite por clave y minuto). Ver `Retry-After`.
• 500 `internal`: Error interno.
• 503 `unavailable`: Servicio no disponible temporalmente.

Parámetros

• phoneNumberIdconsulta · string
• limitconsulta · string

  Elementos por página (1–100, por defecto 50).

• cursorconsulta · string

  `nextCursor` de la página anterior (opaco).

Respuesta 200 · { data: [ … ], nextCursor }

Errores

• 400 `invalid_request`: Petición inválida (cuerpo, parámetros o consulta).
• 401 `unauthorized`: Falta la clave, no existe, está revocada o caducó.
• 403 `insufficient_scope`: La clave no tiene el alcance que exige la ruta. `feature_disabled`: La función está desactivada en el workspace.
• 429 `rate_limited`: Demasiadas llamadas (límite por clave y minuto). Ver `Retry-After`.
• 500 `internal`: Error interno.

Parámetros

• idruta · stringobligatorio

  `{canal}__{id}` (p. ej. `whatsapp__573001234567`).

Respuesta 200 · { data }

Errores

• 400 `invalid_request`: Petición inválida (cuerpo, parámetros o consulta).
• 401 `unauthorized`: Falta la clave, no existe, está revocada o caducó.
• 403 `insufficient_scope`: La clave no tiene el alcance que exige la ruta.
• 404 `not_found`: No existe (o no es de este workspace).
• 429 `rate_limited`: Demasiadas llamadas (límite por clave y minuto). Ver `Retry-After`.
• 500 `internal`: Error interno.

Parámetros

• statusconsulta · "open" | "closed" | "snoozed"
• channelconsulta · "whatsapp" | "telegram" | "sms" | "email"
• assigneeEmailconsulta · string (email)
• limitconsulta · string

  Elementos por página (1–100, por defecto 50).

• cursorconsulta · string

  `nextCursor` de la página anterior (opaco).

Respuesta 200 · { data: [ … ], nextCursor }

Errores

• 400 `invalid_request`: Petición inválida (cuerpo, parámetros o consulta).
• 401 `unauthorized`: Falta la clave, no existe, está revocada o caducó.
• 402 `contact_limit_exceeded`: Límite de contactos del plan superado: el workspace está bloqueado hasta subir de plan o de tramo (reintentar no lo arregla).
• 403 `insufficient_scope`: La clave no tiene el alcance que exige la ruta.
• 429 `rate_limited`: Demasiadas llamadas (límite por clave y minuto). Ver `Retry-After`.
• 500 `internal`: Error interno.

Parámetros

• idruta · stringobligatorio

  `{canal}__{id}` (p. ej. `whatsapp__573001234567`).

Respuesta 200 · { data }

Errores

• 400 `invalid_request`: Petición inválida (cuerpo, parámetros o consulta).
• 401 `unauthorized`: Falta la clave, no existe, está revocada o caducó.
• 403 `insufficient_scope`: La clave no tiene el alcance que exige la ruta.
• 404 `not_found`: No existe (o no es de este workspace).
• 429 `rate_limited`: Demasiadas llamadas (límite por clave y minuto). Ver `Retry-After`.
• 500 `internal`: Error interno.

Parámetros

• idruta · stringobligatorio

  `{canal}__{id}` (p. ej. `whatsapp__573001234567`).

• limitconsulta · string

  Elementos por página (1–100, por defecto 50).

• cursorconsulta · string

  `nextCursor` de la página anterior (opaco).

Respuesta 200 · { data: [ … ], nextCursor }

Errores

• 400 `invalid_request`: Petición inválida (cuerpo, parámetros o consulta).
• 401 `unauthorized`: Falta la clave, no existe, está revocada o caducó.
• 403 `insufficient_scope`: La clave no tiene el alcance que exige la ruta.
• 404 `not_found`: No existe (o no es de este workspace).
• 429 `rate_limited`: Demasiadas llamadas (límite por clave y minuto). Ver `Retry-After`.
• 500 `internal`: Error interno.

Parámetros

• idruta · stringobligatorio

  `{canal}__{id}` (p. ej. `whatsapp__573001234567`).

• Idempotency-Keycabecera · string

  Clave única por operación (≤ 255 caracteres). Repetir la misma petición devuelve la misma respuesta durante 24 h; con otro cuerpo, 422.

Cuerpo

Respuesta 201 · { data }

Errores

• 400 `invalid_request`: Petición inválida (cuerpo, parámetros o consulta).
• 401 `unauthorized`: Falta la clave, no existe, está revocada o caducó.
• 402 `contact_limit_exceeded`: Límite de contactos del plan superado: el workspace está bloqueado hasta subir de plan o de tramo (reintentar no lo arregla). `quota_exceeded`: Cuota mensual del plan agotada: reintentar no lo arregla.
• 403 `insufficient_scope`: La clave no tiene el alcance que exige la ruta. `forbidden`: Operación no permitida.
• 404 `not_found`: No existe (o no es de este workspace).
• 409 `invalid_state`: Operación no válida en el estado actual. `unknown_outcome`: El proveedor no respondió y el mensaje pudo salir. No reintentes con otra Idempotency-Key: podría duplicarse. `idempotency_in_progress`: Otra petición con la misma Idempotency-Key se está procesando.
• 422 `idempotency_key_reused`: La Idempotency-Key ya se usó con otra petición.
• 429 `rate_limited`: Demasiadas llamadas (límite por clave y minuto). Ver `Retry-After`.
• 500 `internal`: Error interno.
• 503 `unavailable`: Servicio no disponible temporalmente.

Parámetros

• idruta · stringobligatorio

  `{canal}__{id}` (p. ej. `whatsapp__573001234567`).

• Idempotency-Keycabecera · string

  Clave única por operación (≤ 255 caracteres). Repetir la misma petición devuelve la misma respuesta durante 24 h; con otro cuerpo, 422.

Cuerpo

Respuesta 200 · { data }

Errores

• 400 `invalid_request`: Petición inválida (cuerpo, parámetros o consulta).
• 401 `unauthorized`: Falta la clave, no existe, está revocada o caducó.
• 403 `insufficient_scope`: La clave no tiene el alcance que exige la ruta.
• 404 `not_found`: No existe (o no es de este workspace).
• 409 `rev_mismatch`: Otro cambio llegó antes (`expectedRev` desactualizado). `idempotency_in_progress`: Otra petición con la misma Idempotency-Key se está procesando.
• 422 `idempotency_key_reused`: La Idempotency-Key ya se usó con otra petición.
• 429 `rate_limited`: Demasiadas llamadas (límite por clave y minuto). Ver `Retry-After`.
• 500 `internal`: Error interno.

Parámetros

• idruta · stringobligatorio

  `{canal}__{id}` (p. ej. `whatsapp__573001234567`).

• Idempotency-Keycabecera · string

  Clave única por operación (≤ 255 caracteres). Repetir la misma petición devuelve la misma respuesta durante 24 h; con otro cuerpo, 422.

Cuerpo

Respuesta 200 · { data }

Errores

• 400 `invalid_request`: Petición inválida (cuerpo, parámetros o consulta).
• 401 `unauthorized`: Falta la clave, no existe, está revocada o caducó.
• 403 `insufficient_scope`: La clave no tiene el alcance que exige la ruta.
• 404 `not_found`: No existe (o no es de este workspace).
• 409 `rev_mismatch`: Otro cambio llegó antes (`expectedRev` desactualizado). `idempotency_in_progress`: Otra petición con la misma Idempotency-Key se está procesando.
• 422 `idempotency_key_reused`: La Idempotency-Key ya se usó con otra petición.
• 429 `rate_limited`: Demasiadas llamadas (límite por clave y minuto). Ver `Retry-After`.
• 500 `internal`: Error interno.

Parámetros

• idruta · stringobligatorio

  `{canal}__{id}` (p. ej. `whatsapp__573001234567`).

• Idempotency-Keycabecera · string

  Clave única por operación (≤ 255 caracteres). Repetir la misma petición devuelve la misma respuesta durante 24 h; con otro cuerpo, 422.

Cuerpo

Respuesta 200 · { data }

Errores

• 400 `invalid_request`: Petición inválida (cuerpo, parámetros o consulta).
• 401 `unauthorized`: Falta la clave, no existe, está revocada o caducó.
• 403 `insufficient_scope`: La clave no tiene el alcance que exige la ruta.
• 404 `not_found`: No existe (o no es de este workspace).
• 409 `rev_mismatch`: Otro cambio llegó antes (`expectedRev` desactualizado). `idempotency_in_progress`: Otra petición con la misma Idempotency-Key se está procesando.
• 422 `idempotency_key_reused`: La Idempotency-Key ya se usó con otra petición.
• 429 `rate_limited`: Demasiadas llamadas (límite por clave y minuto). Ver `Retry-After`.
• 500 `internal`: Error interno.

Parámetros

• statusconsulta · "open" | "in_progress" | "waiting_customer" | "closed"
• priorityconsulta · "low" | "medium" | "high" | "urgent"
• assigneeEmailconsulta · string (email)
• leadIdconsulta · string

  Tickets de un contacto (no se combina con los demás filtros).

• limitconsulta · string

  Elementos por página (1–100, por defecto 50).

• cursorconsulta · string

  `nextCursor` de la página anterior (opaco).

Respuesta 200 · { data: [ … ], nextCursor }

Errores

• 400 `invalid_request`: Petición inválida (cuerpo, parámetros o consulta).
• 401 `unauthorized`: Falta la clave, no existe, está revocada o caducó.
• 402 `contact_limit_exceeded`: Límite de contactos del plan superado: el workspace está bloqueado hasta subir de plan o de tramo (reintentar no lo arregla).
• 403 `insufficient_scope`: La clave no tiene el alcance que exige la ruta.
• 429 `rate_limited`: Demasiadas llamadas (límite por clave y minuto). Ver `Retry-After`.
• 500 `internal`: Error interno.

Parámetros

• Idempotency-Keycabecera · string

  Clave única por operación (≤ 255 caracteres). Repetir la misma petición devuelve la misma respuesta durante 24 h; con otro cuerpo, 422.

Cuerpo

Respuesta 201 · { data }

Errores

• 400 `invalid_request`: Petición inválida (cuerpo, parámetros o consulta).
• 401 `unauthorized`: Falta la clave, no existe, está revocada o caducó.
• 403 `insufficient_scope`: La clave no tiene el alcance que exige la ruta.
• 404 `not_found`: No existe (o no es de este workspace).
• 409 `invalid_state`: Operación no válida en el estado actual. `idempotency_in_progress`: Otra petición con la misma Idempotency-Key se está procesando.
• 422 `idempotency_key_reused`: La Idempotency-Key ya se usó con otra petición.
• 429 `rate_limited`: Demasiadas llamadas (límite por clave y minuto). Ver `Retry-After`.
• 500 `internal`: Error interno.

Parámetros

• idruta · stringobligatorio

Respuesta 200 · { data }

Errores

• 400 `invalid_request`: Petición inválida (cuerpo, parámetros o consulta).
• 401 `unauthorized`: Falta la clave, no existe, está revocada o caducó.
• 403 `insufficient_scope`: La clave no tiene el alcance que exige la ruta.
• 404 `not_found`: No existe (o no es de este workspace).
• 429 `rate_limited`: Demasiadas llamadas (límite por clave y minuto). Ver `Retry-After`.
• 500 `internal`: Error interno.

Parámetros

• idruta · stringobligatorio
• Idempotency-Keycabecera · string

  Clave única por operación (≤ 255 caracteres). Repetir la misma petición devuelve la misma respuesta durante 24 h; con otro cuerpo, 422.

Cuerpo

Respuesta 200 · { data }

Errores

• 400 `invalid_request`: Petición inválida (cuerpo, parámetros o consulta).
• 401 `unauthorized`: Falta la clave, no existe, está revocada o caducó.
• 403 `insufficient_scope`: La clave no tiene el alcance que exige la ruta.
• 404 `not_found`: No existe (o no es de este workspace).
• 409 `rev_mismatch`: Otro cambio llegó antes (`expectedRev` desactualizado). `idempotency_in_progress`: Otra petición con la misma Idempotency-Key se está procesando.
• 422 `idempotency_key_reused`: La Idempotency-Key ya se usó con otra petición.
• 429 `rate_limited`: Demasiadas llamadas (límite por clave y minuto). Ver `Retry-After`.
• 500 `internal`: Error interno.

Parámetros

• idruta · stringobligatorio
• Idempotency-Keycabecera · string

  Clave única por operación (≤ 255 caracteres). Repetir la misma petición devuelve la misma respuesta durante 24 h; con otro cuerpo, 422.

Cuerpo

Respuesta 200 · { data }

Errores

• 400 `invalid_request`: Petición inválida (cuerpo, parámetros o consulta).
• 401 `unauthorized`: Falta la clave, no existe, está revocada o caducó.
• 403 `insufficient_scope`: La clave no tiene el alcance que exige la ruta.
• 404 `not_found`: No existe (o no es de este workspace).
• 409 `rev_mismatch`: Otro cambio llegó antes (`expectedRev` desactualizado). `invalid_state`: Operación no válida en el estado actual. `idempotency_in_progress`: Otra petición con la misma Idempotency-Key se está procesando.
• 422 `idempotency_key_reused`: La Idempotency-Key ya se usó con otra petición.
• 429 `rate_limited`: Demasiadas llamadas (límite por clave y minuto). Ver `Retry-After`.
• 500 `internal`: Error interno.

Parámetros

• idruta · stringobligatorio
• Idempotency-Keycabecera · string

  Clave única por operación (≤ 255 caracteres). Repetir la misma petición devuelve la misma respuesta durante 24 h; con otro cuerpo, 422.

Cuerpo

Respuesta 200 · { data }

Errores

• 400 `invalid_request`: Petición inválida (cuerpo, parámetros o consulta).
• 401 `unauthorized`: Falta la clave, no existe, está revocada o caducó.
• 403 `insufficient_scope`: La clave no tiene el alcance que exige la ruta.
• 404 `not_found`: No existe (o no es de este workspace).
• 409 `rev_mismatch`: Otro cambio llegó antes (`expectedRev` desactualizado). `idempotency_in_progress`: Otra petición con la misma Idempotency-Key se está procesando.
• 422 `idempotency_key_reused`: La Idempotency-Key ya se usó con otra petición.
• 429 `rate_limited`: Demasiadas llamadas (límite por clave y minuto). Ver `Retry-After`.
• 500 `internal`: Error interno.

Parámetros

• idruta · stringobligatorio
• Idempotency-Keycabecera · string

  Clave única por operación (≤ 255 caracteres). Repetir la misma petición devuelve la misma respuesta durante 24 h; con otro cuerpo, 422.

Cuerpo

Respuesta 200 · { data }

Errores

• 400 `invalid_request`: Petición inválida (cuerpo, parámetros o consulta).
• 401 `unauthorized`: Falta la clave, no existe, está revocada o caducó.
• 403 `insufficient_scope`: La clave no tiene el alcance que exige la ruta.
• 404 `not_found`: No existe (o no es de este workspace).
• 409 `rev_mismatch`: Otro cambio llegó antes (`expectedRev` desactualizado). `idempotency_in_progress`: Otra petición con la misma Idempotency-Key se está procesando.
• 422 `idempotency_key_reused`: La Idempotency-Key ya se usó con otra petición.
• 429 `rate_limited`: Demasiadas llamadas (límite por clave y minuto). Ver `Retry-After`.
• 500 `internal`: Error interno.

Parámetros

• idruta · stringobligatorio
• Idempotency-Keycabecera · string

  Clave única por operación (≤ 255 caracteres). Repetir la misma petición devuelve la misma respuesta durante 24 h; con otro cuerpo, 422.

Cuerpo

Respuesta 201 · { data }

Errores

• 400 `invalid_request`: Petición inválida (cuerpo, parámetros o consulta).
• 401 `unauthorized`: Falta la clave, no existe, está revocada o caducó.
• 403 `insufficient_scope`: La clave no tiene el alcance que exige la ruta.
• 404 `not_found`: No existe (o no es de este workspace).
• 409 `idempotency_in_progress`: Otra petición con la misma Idempotency-Key se está procesando.
• 422 `idempotency_key_reused`: La Idempotency-Key ya se usó con otra petición.
• 429 `rate_limited`: Demasiadas llamadas (límite por clave y minuto). Ver `Retry-After`.
• 500 `internal`: Error interno.

Parámetros

• fromconsulta · string (date) | string (date-time)

  Desde (inicio de la reunión).

• toconsulta · string (date) | string (date-time)

  Hasta (inicio de la reunión).

• limitconsulta · string

  Elementos por página (1–100, por defecto 50).

• cursorconsulta · string

  `nextCursor` de la página anterior (opaco).

Respuesta 200 · { data: [ … ], nextCursor }

Errores

• 400 `invalid_request`: Petición inválida (cuerpo, parámetros o consulta).
• 401 `unauthorized`: Falta la clave, no existe, está revocada o caducó.
• 402 `contact_limit_exceeded`: Límite de contactos del plan superado: el workspace está bloqueado hasta subir de plan o de tramo (reintentar no lo arregla).
• 403 `insufficient_scope`: La clave no tiene el alcance que exige la ruta. `feature_disabled`: La función está desactivada en el workspace.
• 429 `rate_limited`: Demasiadas llamadas (límite por clave y minuto). Ver `Retry-After`.
• 500 `internal`: Error interno.

Parámetros

• idruta · stringobligatorio

Respuesta 200 · { data }

Errores

• 400 `invalid_request`: Petición inválida (cuerpo, parámetros o consulta).
• 401 `unauthorized`: Falta la clave, no existe, está revocada o caducó.
• 403 `insufficient_scope`: La clave no tiene el alcance que exige la ruta. `feature_disabled`: La función está desactivada en el workspace.
• 404 `not_found`: No existe (o no es de este workspace).
• 429 `rate_limited`: Demasiadas llamadas (límite por clave y minuto). Ver `Retry-After`.
• 500 `internal`: Error interno.

Parámetros

• idruta · stringobligatorio
• Idempotency-Keycabecera · string

  Clave única por operación (≤ 255 caracteres). Repetir la misma petición devuelve la misma respuesta durante 24 h; con otro cuerpo, 422.

Cuerpo

Respuesta 200 · { data }

Errores

• 400 `invalid_request`: Petición inválida (cuerpo, parámetros o consulta).
• 401 `unauthorized`: Falta la clave, no existe, está revocada o caducó.
• 403 `insufficient_scope`: La clave no tiene el alcance que exige la ruta. `feature_disabled`: La función está desactivada en el workspace.
• 404 `not_found`: No existe (o no es de este workspace).
• 409 `conflict`: Conflicto con el estado actual (p. ej. ya existe). `invalid_state`: Operación no válida en el estado actual. `idempotency_in_progress`: Otra petición con la misma Idempotency-Key se está procesando.
• 422 `idempotency_key_reused`: La Idempotency-Key ya se usó con otra petición.
• 429 `rate_limited`: Demasiadas llamadas (límite por clave y minuto). Ver `Retry-After`.
• 500 `internal`: Error interno.

Parámetros

• idruta · stringobligatorio
• Idempotency-Keycabecera · string

  Clave única por operación (≤ 255 caracteres). Repetir la misma petición devuelve la misma respuesta durante 24 h; con otro cuerpo, 422.

Cuerpo

Respuesta 200 · { data }

Errores

• 400 `invalid_request`: Petición inválida (cuerpo, parámetros o consulta).
• 401 `unauthorized`: Falta la clave, no existe, está revocada o caducó.
• 403 `insufficient_scope`: La clave no tiene el alcance que exige la ruta. `feature_disabled`: La función está desactivada en el workspace.
• 404 `not_found`: No existe (o no es de este workspace).
• 409 `invalid_state`: Operación no válida en el estado actual. `idempotency_in_progress`: Otra petición con la misma Idempotency-Key se está procesando.
• 422 `idempotency_key_reused`: La Idempotency-Key ya se usó con otra petición.
• 429 `rate_limited`: Demasiadas llamadas (límite por clave y minuto). Ver `Retry-After`.
• 500 `internal`: Error interno.

Respuesta 200 · { data: [ … ], nextCursor }

Errores

• 400 `invalid_request`: Petición inválida (cuerpo, parámetros o consulta).
• 401 `unauthorized`: Falta la clave, no existe, está revocada o caducó.
• 403 `insufficient_scope`: La clave no tiene el alcance que exige la ruta. `feature_disabled`: La función está desactivada en el workspace.
• 429 `rate_limited`: Demasiadas llamadas (límite por clave y minuto). Ver `Retry-After`.
• 500 `internal`: Error interno.

Parámetros

• idruta · stringobligatorio
• contactIdconsulta · stringobligatorio

  Contacto que reserva (define el anfitrión si el tipo es «del dueño»).

• fromconsulta · string (date) | string (date-time)
• toconsulta · string (date) | string (date-time)
• localeconsulta · "es" | "en" | "pt"

Respuesta 200 · { data }

Errores

• 400 `invalid_request`: Petición inválida (cuerpo, parámetros o consulta).
• 401 `unauthorized`: Falta la clave, no existe, está revocada o caducó.
• 403 `insufficient_scope`: La clave no tiene el alcance que exige la ruta. `feature_disabled`: La función está desactivada en el workspace.
• 404 `not_found`: No existe (o no es de este workspace).
• 409 `invalid_state`: Operación no válida en el estado actual.
• 429 `rate_limited`: Demasiadas llamadas (límite por clave y minuto). Ver `Retry-After`.
• 500 `internal`: Error interno.
• 503 `unavailable`: Servicio no disponible temporalmente.

Parámetros

• idruta · stringobligatorio
• Idempotency-Keycabecera · string

  Clave única por operación (≤ 255 caracteres). Repetir la misma petición devuelve la misma respuesta durante 24 h; con otro cuerpo, 422.

Cuerpo

Respuesta 201 · { data }

Errores

• 400 `invalid_request`: Petición inválida (cuerpo, parámetros o consulta).
• 401 `unauthorized`: Falta la clave, no existe, está revocada o caducó.
• 403 `insufficient_scope`: La clave no tiene el alcance que exige la ruta. `feature_disabled`: La función está desactivada en el workspace.
• 404 `not_found`: No existe (o no es de este workspace).
• 409 `conflict`: Conflicto con el estado actual (p. ej. ya existe). `invalid_state`: Operación no válida en el estado actual. `idempotency_in_progress`: Otra petición con la misma Idempotency-Key se está procesando.
• 422 `idempotency_key_reused`: La Idempotency-Key ya se usó con otra petición.
• 429 `rate_limited`: Demasiadas llamadas (límite por clave y minuto). Ver `Retry-After`.
• 500 `internal`: Error interno.
• 503 `unavailable`: Servicio no disponible temporalmente.

Respuesta 200 · { data: [ … ], nextCursor }

Errores

• 400 `invalid_request`: Petición inválida (cuerpo, parámetros o consulta).
• 401 `unauthorized`: Falta la clave, no existe, está revocada o caducó.
• 403 `insufficient_scope`: La clave no tiene el alcance que exige la ruta.
• 429 `rate_limited`: Demasiadas llamadas (límite por clave y minuto). Ver `Retry-After`.
• 500 `internal`: Error interno.

Parámetros

• Idempotency-Keycabecera · string

  Clave única por operación (≤ 255 caracteres). Repetir la misma petición devuelve la misma respuesta durante 24 h; con otro cuerpo, 422.

Cuerpo

Respuesta 201 · { data }

Errores

• 400 `invalid_request`: Petición inválida (cuerpo, parámetros o consulta).
• 401 `unauthorized`: Falta la clave, no existe, está revocada o caducó.
• 403 `insufficient_scope`: La clave no tiene el alcance que exige la ruta.
• 409 `conflict`: Conflicto con el estado actual (p. ej. ya existe). `idempotency_in_progress`: Otra petición con la misma Idempotency-Key se está procesando.
• 422 `idempotency_key_reused`: La Idempotency-Key ya se usó con otra petición.
• 429 `rate_limited`: Demasiadas llamadas (límite por clave y minuto). Ver `Retry-After`.
• 500 `internal`: Error interno.

Parámetros

• idruta · stringobligatorio
• Idempotency-Keycabecera · string

  Clave única por operación (≤ 255 caracteres). Repetir la misma petición devuelve la misma respuesta durante 24 h; con otro cuerpo, 422.

Cuerpo

Respuesta 200 · { data }

Errores

• 400 `invalid_request`: Petición inválida (cuerpo, parámetros o consulta).
• 401 `unauthorized`: Falta la clave, no existe, está revocada o caducó.
• 403 `insufficient_scope`: La clave no tiene el alcance que exige la ruta.
• 404 `not_found`: No existe (o no es de este workspace).
• 409 `idempotency_in_progress`: Otra petición con la misma Idempotency-Key se está procesando.
• 422 `idempotency_key_reused`: La Idempotency-Key ya se usó con otra petición.
• 429 `rate_limited`: Demasiadas llamadas (límite por clave y minuto). Ver `Retry-After`.
• 500 `internal`: Error interno.

Parámetros

• idruta · stringobligatorio
• Idempotency-Keycabecera · string

  Clave única por operación (≤ 255 caracteres). Repetir la misma petición devuelve la misma respuesta durante 24 h; con otro cuerpo, 422.

Respuesta 200 · { data }

Errores

• 400 `invalid_request`: Petición inválida (cuerpo, parámetros o consulta).
• 401 `unauthorized`: Falta la clave, no existe, está revocada o caducó.
• 403 `insufficient_scope`: La clave no tiene el alcance que exige la ruta.
• 404 `not_found`: No existe (o no es de este workspace).
• 409 `idempotency_in_progress`: Otra petición con la misma Idempotency-Key se está procesando.
• 422 `idempotency_key_reused`: La Idempotency-Key ya se usó con otra petición.
• 429 `rate_limited`: Demasiadas llamadas (límite por clave y minuto). Ver `Retry-After`.
• 500 `internal`: Error interno.

Parámetros

• idruta · stringobligatorio
• Idempotency-Keycabecera · string

  Clave única por operación (≤ 255 caracteres). Repetir la misma petición devuelve la misma respuesta durante 24 h; con otro cuerpo, 422.

Respuesta 200 · { data }

Errores

• 400 `invalid_request`: Petición inválida (cuerpo, parámetros o consulta).
• 401 `unauthorized`: Falta la clave, no existe, está revocada o caducó.
• 403 `insufficient_scope`: La clave no tiene el alcance que exige la ruta.
• 404 `not_found`: No existe (o no es de este workspace).
• 409 `idempotency_in_progress`: Otra petición con la misma Idempotency-Key se está procesando.
• 422 `idempotency_key_reused`: La Idempotency-Key ya se usó con otra petición.
• 429 `rate_limited`: Demasiadas llamadas (límite por clave y minuto). Ver `Retry-After`.
• 500 `internal`: Error interno.

Respuesta 200 · { data: [ … ], nextCursor }

Errores

• 400 `invalid_request`: Petición inválida (cuerpo, parámetros o consulta).
• 401 `unauthorized`: Falta la clave, no existe, está revocada o caducó.
• 403 `insufficient_scope`: La clave no tiene el alcance que exige la ruta.
• 429 `rate_limited`: Demasiadas llamadas (límite por clave y minuto). Ver `Retry-After`.
• 500 `internal`: Error interno.