curl --request PATCH \
--url https://api.craqui.com/v1/clients/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"center_id": "ctr_01j16rq65fme4r990anbaxvxfq",
"metadata": {
"plan_web": "mensual"
}
}
'import requests
url = "https://api.craqui.com/v1/clients/{id}"
payload = {
"center_id": "ctr_01j16rq65fme4r990anbaxvxfq",
"metadata": { "plan_web": "mensual" }
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({center_id: 'ctr_01j16rq65fme4r990anbaxvxfq', metadata: {plan_web: 'mensual'}})
};
fetch('https://api.craqui.com/v1/clients/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.craqui.com/v1/clients/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'center_id' => 'ctr_01j16rq65fme4r990anbaxvxfq',
'metadata' => [
'plan_web' => 'mensual'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.craqui.com/v1/clients/{id}"
payload := strings.NewReader("{\n \"center_id\": \"ctr_01j16rq65fme4r990anbaxvxfq\",\n \"metadata\": {\n \"plan_web\": \"mensual\"\n }\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://api.craqui.com/v1/clients/{id}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"center_id\": \"ctr_01j16rq65fme4r990anbaxvxfq\",\n \"metadata\": {\n \"plan_web\": \"mensual\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.craqui.com/v1/clients/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"center_id\": \"ctr_01j16rq65fme4r990anbaxvxfq\",\n \"metadata\": {\n \"plan_web\": \"mensual\"\n }\n}"
response = http.request(request)
puts response.read_body{
"object": "preview",
"livemode": true,
"action": "client.update",
"result": {
"id": "cli_01jqy553dmxw6vmq7g5vzfa9yz",
"object": "client",
"livemode": true,
"first_name": "Joaquín",
"last_name": "Méndez",
"status": "active",
"home_center_id": "ctr_01j16rq65fme4r990anbaxvxfq",
"created_at": "2026-03-02T19:20:00-03:00",
"updated_at": "2026-11-02T00:00:00-03:00",
"metadata": {
"crm_code": "48213",
"plan_web": "mensual"
}
},
"effects": {
"client_created": false,
"notifies_client": false,
"notifies_staff": false,
"changed_fields": [
"center_id",
"metadata"
]
},
"warnings": [],
"summary": "Se actualizan los datos del cliente."
}{
"type": "https://docs.craqui.com/errors/invalid_api_key",
"title": "La clave no es válida",
"status": 401,
"code": "invalid_api_key",
"request_id": "req_01hzx8m4k2a7d9q3f5w6y8z0bc",
"detail": "Revisa que copiaste la clave completa, incluido el prefijo (crq_live_ o crq_test_).",
"doc_url": "<string>",
"required_scope": "business:read",
"errors": [
{
"field": "limit",
"code": "invalid_limit",
"detail": "<string>"
}
],
"current_price": {
"amount_cents": 250000,
"currency": "UYU"
},
"expected_amount": {
"amount_cents": 250000,
"currency": "UYU"
},
"amount_at_stake": {
"amount_cents": 250000,
"currency": "UYU"
},
"existing_membership_id": "mem_01j1q27t44qvr6v2s50cv4rbvq",
"booking_ids": [
"bkg_01jx9eak0437zdf0yw0atg7g0r"
]
}{
"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"
}{
"type": "https://docs.craqui.com/errors/invalid_api_key",
"title": "La clave no es válida",
"status": 401,
"code": "invalid_api_key",
"request_id": "req_01hzx8m4k2a7d9q3f5w6y8z0bc",
"detail": "Revisa que copiaste la clave completa, incluido el prefijo (crq_live_ o crq_test_).",
"doc_url": "<string>",
"required_scope": "business:read",
"errors": [
{
"field": "limit",
"code": "invalid_limit",
"detail": "<string>"
}
],
"current_price": {
"amount_cents": 250000,
"currency": "UYU"
},
"expected_amount": {
"amount_cents": 250000,
"currency": "UYU"
},
"amount_at_stake": {
"amount_cents": 250000,
"currency": "UYU"
},
"existing_membership_id": "mem_01j1q27t44qvr6v2s50cv4rbvq",
"booking_ids": [
"bkg_01jx9eak0437zdf0yw0atg7g0r"
]
}{
"type": "https://docs.craqui.com/errors/invalid_api_key",
"title": "La clave no es válida",
"status": 401,
"code": "invalid_api_key",
"request_id": "req_01hzx8m4k2a7d9q3f5w6y8z0bc",
"detail": "Revisa que copiaste la clave completa, incluido el prefijo (crq_live_ o crq_test_).",
"doc_url": "<string>",
"required_scope": "business:read",
"errors": [
{
"field": "limit",
"code": "invalid_limit",
"detail": "<string>"
}
],
"current_price": {
"amount_cents": 250000,
"currency": "UYU"
},
"expected_amount": {
"amount_cents": 250000,
"currency": "UYU"
},
"amount_at_stake": {
"amount_cents": 250000,
"currency": "UYU"
},
"existing_membership_id": "mem_01j1q27t44qvr6v2s50cv4rbvq",
"booking_ids": [
"bkg_01jx9eak0437zdf0yw0atg7g0r"
]
}{
"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"
}{
"type": "https://docs.craqui.com/errors/invalid_api_key",
"title": "La clave no es válida",
"status": 401,
"code": "invalid_api_key",
"request_id": "req_01hzx8m4k2a7d9q3f5w6y8z0bc",
"detail": "Revisa que copiaste la clave completa, incluido el prefijo (crq_live_ o crq_test_).",
"doc_url": "<string>",
"required_scope": "business:read",
"errors": [
{
"field": "limit",
"code": "invalid_limit",
"detail": "<string>"
}
],
"current_price": {
"amount_cents": 250000,
"currency": "UYU"
},
"expected_amount": {
"amount_cents": 250000,
"currency": "UYU"
},
"amount_at_stake": {
"amount_cents": 250000,
"currency": "UYU"
},
"existing_membership_id": "mem_01j1q27t44qvr6v2s50cv4rbvq",
"booking_ids": [
"bkg_01jx9eak0437zdf0yw0atg7g0r"
]
}{
"type": "https://docs.craqui.com/errors/invalid_api_key",
"title": "La clave no es válida",
"status": 401,
"code": "invalid_api_key",
"request_id": "req_01hzx8m4k2a7d9q3f5w6y8z0bc",
"detail": "Revisa que copiaste la clave completa, incluido el prefijo (crq_live_ o crq_test_).",
"doc_url": "<string>",
"required_scope": "business:read",
"errors": [
{
"field": "limit",
"code": "invalid_limit",
"detail": "<string>"
}
],
"current_price": {
"amount_cents": 250000,
"currency": "UYU"
},
"expected_amount": {
"amount_cents": 250000,
"currency": "UYU"
},
"amount_at_stake": {
"amount_cents": 250000,
"currency": "UYU"
},
"existing_membership_id": "mem_01j1q27t44qvr6v2s50cv4rbvq",
"booking_ids": [
"bkg_01jx9eak0437zdf0yw0atg7g0r"
]
}{
"type": "https://docs.craqui.com/errors/invalid_api_key",
"title": "La clave no es válida",
"status": 401,
"code": "invalid_api_key",
"request_id": "req_01hzx8m4k2a7d9q3f5w6y8z0bc",
"detail": "Revisa que copiaste la clave completa, incluido el prefijo (crq_live_ o crq_test_).",
"doc_url": "<string>",
"required_scope": "business:read",
"errors": [
{
"field": "limit",
"code": "invalid_limit",
"detail": "<string>"
}
],
"current_price": {
"amount_cents": 250000,
"currency": "UYU"
},
"expected_amount": {
"amount_cents": 250000,
"currency": "UYU"
},
"amount_at_stake": {
"amount_cents": 250000,
"currency": "UYU"
},
"existing_membership_id": "mem_01j1q27t44qvr6v2s50cv4rbvq",
"booking_ids": [
"bkg_01jx9eak0437zdf0yw0atg7g0r"
]
}{
"type": "https://docs.craqui.com/errors/invalid_api_key",
"title": "La clave no es válida",
"status": 401,
"code": "invalid_api_key",
"request_id": "req_01hzx8m4k2a7d9q3f5w6y8z0bc",
"detail": "Revisa que copiaste la clave completa, incluido el prefijo (crq_live_ o crq_test_).",
"doc_url": "<string>",
"required_scope": "business:read",
"errors": [
{
"field": "limit",
"code": "invalid_limit",
"detail": "<string>"
}
],
"current_price": {
"amount_cents": 250000,
"currency": "UYU"
},
"expected_amount": {
"amount_cents": 250000,
"currency": "UYU"
},
"amount_at_stake": {
"amount_cents": 250000,
"currency": "UYU"
},
"existing_membership_id": "mem_01j1q27t44qvr6v2s50cv4rbvq",
"booking_ids": [
"bkg_01jx9eak0437zdf0yw0atg7g0r"
]
}Cambiar los datos de un cliente
Cambia solo los campos que mandas: first_name, last_name, phone, phone_country_code, center_id y
metadata (que se combina con la guardada; una clave con null se borra). El email no se cambia por la API
(validation_failed con not_updatable). Al cliente no le llega ningún aviso.
Con If-Match (el ETag de tu última lectura), el cambio se aplica solo si nadie cambió el cliente desde
entonces; si cambió, 412 precondition_failed y no se cambia nada. Repetir el mismo cambio responde 200 sin
cambiar nada. Responde el cliente como queda, con su ETag nuevo. Con dry_run=true responde 200 con la
vista previa.
Rechazos (409): profile_shared_with_other_business (el cliente también está en otro negocio de Craqui:
su nombre y su teléfono no se cambian por la API; no se cambia nada), client_is_staff (también es del
equipo del estudio: lo mismo), client_unreachable (quedaría sin email ni teléfono), phone_in_use (el
teléfono nuevo de un cliente sin email ya es de otro cliente). Un cliente que no es de tu negocio, o un center_id de otro, 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).
curl --request PATCH \
--url https://api.craqui.com/v1/clients/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"center_id": "ctr_01j16rq65fme4r990anbaxvxfq",
"metadata": {
"plan_web": "mensual"
}
}
'import requests
url = "https://api.craqui.com/v1/clients/{id}"
payload = {
"center_id": "ctr_01j16rq65fme4r990anbaxvxfq",
"metadata": { "plan_web": "mensual" }
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({center_id: 'ctr_01j16rq65fme4r990anbaxvxfq', metadata: {plan_web: 'mensual'}})
};
fetch('https://api.craqui.com/v1/clients/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.craqui.com/v1/clients/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'center_id' => 'ctr_01j16rq65fme4r990anbaxvxfq',
'metadata' => [
'plan_web' => 'mensual'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.craqui.com/v1/clients/{id}"
payload := strings.NewReader("{\n \"center_id\": \"ctr_01j16rq65fme4r990anbaxvxfq\",\n \"metadata\": {\n \"plan_web\": \"mensual\"\n }\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://api.craqui.com/v1/clients/{id}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"center_id\": \"ctr_01j16rq65fme4r990anbaxvxfq\",\n \"metadata\": {\n \"plan_web\": \"mensual\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.craqui.com/v1/clients/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"center_id\": \"ctr_01j16rq65fme4r990anbaxvxfq\",\n \"metadata\": {\n \"plan_web\": \"mensual\"\n }\n}"
response = http.request(request)
puts response.read_body{
"object": "preview",
"livemode": true,
"action": "client.update",
"result": {
"id": "cli_01jqy553dmxw6vmq7g5vzfa9yz",
"object": "client",
"livemode": true,
"first_name": "Joaquín",
"last_name": "Méndez",
"status": "active",
"home_center_id": "ctr_01j16rq65fme4r990anbaxvxfq",
"created_at": "2026-03-02T19:20:00-03:00",
"updated_at": "2026-11-02T00:00:00-03:00",
"metadata": {
"crm_code": "48213",
"plan_web": "mensual"
}
},
"effects": {
"client_created": false,
"notifies_client": false,
"notifies_staff": false,
"changed_fields": [
"center_id",
"metadata"
]
},
"warnings": [],
"summary": "Se actualizan los datos del cliente."
}{
"type": "https://docs.craqui.com/errors/invalid_api_key",
"title": "La clave no es válida",
"status": 401,
"code": "invalid_api_key",
"request_id": "req_01hzx8m4k2a7d9q3f5w6y8z0bc",
"detail": "Revisa que copiaste la clave completa, incluido el prefijo (crq_live_ o crq_test_).",
"doc_url": "<string>",
"required_scope": "business:read",
"errors": [
{
"field": "limit",
"code": "invalid_limit",
"detail": "<string>"
}
],
"current_price": {
"amount_cents": 250000,
"currency": "UYU"
},
"expected_amount": {
"amount_cents": 250000,
"currency": "UYU"
},
"amount_at_stake": {
"amount_cents": 250000,
"currency": "UYU"
},
"existing_membership_id": "mem_01j1q27t44qvr6v2s50cv4rbvq",
"booking_ids": [
"bkg_01jx9eak0437zdf0yw0atg7g0r"
]
}{
"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"
}{
"type": "https://docs.craqui.com/errors/invalid_api_key",
"title": "La clave no es válida",
"status": 401,
"code": "invalid_api_key",
"request_id": "req_01hzx8m4k2a7d9q3f5w6y8z0bc",
"detail": "Revisa que copiaste la clave completa, incluido el prefijo (crq_live_ o crq_test_).",
"doc_url": "<string>",
"required_scope": "business:read",
"errors": [
{
"field": "limit",
"code": "invalid_limit",
"detail": "<string>"
}
],
"current_price": {
"amount_cents": 250000,
"currency": "UYU"
},
"expected_amount": {
"amount_cents": 250000,
"currency": "UYU"
},
"amount_at_stake": {
"amount_cents": 250000,
"currency": "UYU"
},
"existing_membership_id": "mem_01j1q27t44qvr6v2s50cv4rbvq",
"booking_ids": [
"bkg_01jx9eak0437zdf0yw0atg7g0r"
]
}{
"type": "https://docs.craqui.com/errors/invalid_api_key",
"title": "La clave no es válida",
"status": 401,
"code": "invalid_api_key",
"request_id": "req_01hzx8m4k2a7d9q3f5w6y8z0bc",
"detail": "Revisa que copiaste la clave completa, incluido el prefijo (crq_live_ o crq_test_).",
"doc_url": "<string>",
"required_scope": "business:read",
"errors": [
{
"field": "limit",
"code": "invalid_limit",
"detail": "<string>"
}
],
"current_price": {
"amount_cents": 250000,
"currency": "UYU"
},
"expected_amount": {
"amount_cents": 250000,
"currency": "UYU"
},
"amount_at_stake": {
"amount_cents": 250000,
"currency": "UYU"
},
"existing_membership_id": "mem_01j1q27t44qvr6v2s50cv4rbvq",
"booking_ids": [
"bkg_01jx9eak0437zdf0yw0atg7g0r"
]
}{
"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"
}{
"type": "https://docs.craqui.com/errors/invalid_api_key",
"title": "La clave no es válida",
"status": 401,
"code": "invalid_api_key",
"request_id": "req_01hzx8m4k2a7d9q3f5w6y8z0bc",
"detail": "Revisa que copiaste la clave completa, incluido el prefijo (crq_live_ o crq_test_).",
"doc_url": "<string>",
"required_scope": "business:read",
"errors": [
{
"field": "limit",
"code": "invalid_limit",
"detail": "<string>"
}
],
"current_price": {
"amount_cents": 250000,
"currency": "UYU"
},
"expected_amount": {
"amount_cents": 250000,
"currency": "UYU"
},
"amount_at_stake": {
"amount_cents": 250000,
"currency": "UYU"
},
"existing_membership_id": "mem_01j1q27t44qvr6v2s50cv4rbvq",
"booking_ids": [
"bkg_01jx9eak0437zdf0yw0atg7g0r"
]
}{
"type": "https://docs.craqui.com/errors/invalid_api_key",
"title": "La clave no es válida",
"status": 401,
"code": "invalid_api_key",
"request_id": "req_01hzx8m4k2a7d9q3f5w6y8z0bc",
"detail": "Revisa que copiaste la clave completa, incluido el prefijo (crq_live_ o crq_test_).",
"doc_url": "<string>",
"required_scope": "business:read",
"errors": [
{
"field": "limit",
"code": "invalid_limit",
"detail": "<string>"
}
],
"current_price": {
"amount_cents": 250000,
"currency": "UYU"
},
"expected_amount": {
"amount_cents": 250000,
"currency": "UYU"
},
"amount_at_stake": {
"amount_cents": 250000,
"currency": "UYU"
},
"existing_membership_id": "mem_01j1q27t44qvr6v2s50cv4rbvq",
"booking_ids": [
"bkg_01jx9eak0437zdf0yw0atg7g0r"
]
}{
"type": "https://docs.craqui.com/errors/invalid_api_key",
"title": "La clave no es válida",
"status": 401,
"code": "invalid_api_key",
"request_id": "req_01hzx8m4k2a7d9q3f5w6y8z0bc",
"detail": "Revisa que copiaste la clave completa, incluido el prefijo (crq_live_ o crq_test_).",
"doc_url": "<string>",
"required_scope": "business:read",
"errors": [
{
"field": "limit",
"code": "invalid_limit",
"detail": "<string>"
}
],
"current_price": {
"amount_cents": 250000,
"currency": "UYU"
},
"expected_amount": {
"amount_cents": 250000,
"currency": "UYU"
},
"amount_at_stake": {
"amount_cents": 250000,
"currency": "UYU"
},
"existing_membership_id": "mem_01j1q27t44qvr6v2s50cv4rbvq",
"booking_ids": [
"bkg_01jx9eak0437zdf0yw0atg7g0r"
]
}{
"type": "https://docs.craqui.com/errors/invalid_api_key",
"title": "La clave no es válida",
"status": 401,
"code": "invalid_api_key",
"request_id": "req_01hzx8m4k2a7d9q3f5w6y8z0bc",
"detail": "Revisa que copiaste la clave completa, incluido el prefijo (crq_live_ o crq_test_).",
"doc_url": "<string>",
"required_scope": "business:read",
"errors": [
{
"field": "limit",
"code": "invalid_limit",
"detail": "<string>"
}
],
"current_price": {
"amount_cents": 250000,
"currency": "UYU"
},
"expected_amount": {
"amount_cents": 250000,
"currency": "UYU"
},
"amount_at_stake": {
"amount_cents": 250000,
"currency": "UYU"
},
"existing_membership_id": "mem_01j1q27t44qvr6v2s50cv4rbvq",
"booking_ids": [
"bkg_01jx9eak0437zdf0yw0atg7g0r"
]
}Authorizations
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
Crear, cambiar, dar de baja y reactivar clientes.
Headers
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ó.
^\d{4}-\d{2}-\d{2}$"2026-12-01"
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.
1 - 255El ETag que recibiste al leer el cliente (GET /v1/clients/{id}, o la respuesta de tu última escritura). Con
él, el cambio se aplica solo si el cliente sigue igual; si cambió, la respuesta es 412 precondition_failed y
no se cambia nada. Sin él, el cambio se aplica sobre lo que haya.
200Path Parameters
El id del cliente (cli_…).
Id de un cliente del estudio.
^cli_[0-7][0-9a-hjkmnp-tv-z]{25}$"cli_01jatfha5h4nkg77c3wfrvd3cw"
Query Parameters
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
Solo los campos que cambias. El email no se cambia por la API. Si el cliente también está en otro negocio de
Craqui, su nombre y su teléfono no se cambian (409 profile_shared_with_other_business, sin cambiar nada); la
sede y metadata sí.
1 - 200200Como al dar de alta. null lo borra, si el cliente tiene email.
3010La sede habitual; null lo deja sin sede.
^ctr_[0-7][0-9a-hjkmnp-tv-z]{25}$"ctr_01j65pdnq74qvnh0953pzvtczg"
Se combina con la metadata guardada: una clave con texto la agrega o la reemplaza, una clave con null la
borra y las demás quedan como estaban. El resultado tiene hasta 20 claves.
Show child attributes
Show child attributes
Response
El cliente como queda, o con dry_run=true la vista previa (no se escribió nada).
- Option 1
- Option 2
Lo que haría un alta o un cambio de un cliente, sin hacerlo. Craqui lo evalúa con las mismas reglas que el pedido real: si el real se rechazaría, la vista previa responde el mismo error.
"preview"false si la vista previa es de tu estudio de prueba (claves crq_test_); true con claves crq_live_.
client.create o client.update. La lista puede crecer.
client.create, client.update El cliente como quedaría. En un alta nueva, id es null. En el alta de alguien que ya está en el estudio con
otro rol, sus datos no cambian y no se muestran (first_name y last_name en null). El email y el teléfono,
solo en un cambio y con clients.pii:read.
Show child attributes
Show child attributes
Lo que la escritura de un cliente haría.
Show child attributes
Show child attributes
Lo que conviene saber, como códigos: already_client (ya es cliente del estudio: el alta no cambia nada),
existing_person (ya está en el estudio con otro rol: pasa a ser cliente, con sus datos como están) y
no_change (el cambio no cambia nada). La lista puede crecer.
already_client, existing_person, no_change Lo mismo en una frase en español, para mostrarle a una persona. No nombra al cliente.