Skip to main content
POST
Reactivar a un cliente

Authorizations

Authorization
string
header
required

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.

Scopes

clients:write

Crear, cambiar, dar de baja y reactivar clientes.

Headers

Craqui-Version
string

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ó.

Pattern: ^\d{4}-\d{2}-\d{2}$
Example:

"2026-12-01"

Idempotency-Key
string

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.

Required string length: 1 - 255

Path Parameters

id
string
required

El id del cliente (cli_…). Id de un cliente del estudio.

Pattern: ^cli_[0-7][0-9a-hjkmnp-tv-z]{25}$
Example:

"cli_01jatfha5h4nkg77c3wfrvd3cw"

Query Parameters

dry_run
boolean

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.

Body

application/json

Sin campos (el cuerpo puede faltar); qué hacer está en la ruta.

Response

El cliente como quedó, o con dry_run=true la vista previa (object dice cuál).

Un cliente del estudio. Nunca trae fecha de nacimiento, dirección, documento, datos fiscales, de salud, notas ni contacto de emergencia.

Un cliente deleted (el estudio lo dio de baja) responde solo por id o dentro de un expand, porque una reserva o una cuota vieja sigue apuntando a su id: trae id, status y fechas, con first_name y last_name en null, y nunca email ni phone, con ningún permiso.

id
string
required

Id de un cliente del estudio.

Pattern: ^cli_[0-7][0-9a-hjkmnp-tv-z]{25}$
Example:

"cli_01jatfha5h4nkg77c3wfrvd3cw"

object
string
required
Allowed value: "client"
livemode
boolean
required

false si el objeto es de tu estudio de prueba (claves crq_test_); true con claves crq_live_.

first_name
string | null
required

null en un cliente deleted, o si el estudio no lo cargó.

Example:

"Sofía"

last_name
string | null
required

null en un cliente deleted, o si el estudio no lo cargó.

Example:

"Pérez"

status
enum<string>
required

active, inactive o deleted. Las listas traen solo active e inactive. La lista puede crecer: trata un valor que no conoces como inactivo.

Available options:
active,
inactive,
deleted
home_center_id
string | null
required

La sede habitual del cliente, si el estudio le asignó una.

Pattern: ^ctr_[0-7][0-9a-hjkmnp-tv-z]{25}$
Example:

"ctr_01j65pdnq74qvnh0953pzvtczg"

created_at
string<date-time>
required

Cuándo pasó a ser cliente de este estudio.

Example:

"2026-12-02T19:00:00-03:00"

updated_at
string<date-time>
required

La última vez que cambió algo del cliente, su metadata incluida.

Example:

"2026-12-02T19:00:00-03:00"

metadata
object
required

Lo que tu sistema guardó sobre el cliente ({} si nada). Un cliente deleted trae {}.

email
string | null

Solo con el permiso clients.pii:read: sin él, el campo no viene (no es null). null si el cliente no tiene email.

phone
string | null

Solo con el permiso clients.pii:read: sin él, el campo no viene. En formato E.164 (+59899123456); null si no tiene teléfono o si no se pudo leer como uno.

Pattern: ^\+[1-9]\d{6,14}$
Example:

"+59899123456"

active_membership
object | null

Solo en GET /v1/clients/{id} con expand[]=active_membership (pide memberships:read): la membresía que tiene ahora (la active; si no hay, la más nueva paused, suspended o pending_payment). null si no tiene ninguna.

credit_balance
object

Solo en GET /v1/clients/{id} con expand[]=credit_balance (pide credits:read).