Atualizar agendamento
curl --request PATCH \
--url https://api.controleclinic.com.br/v1/scheduling/appointments/{id} \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"status": "confirmed"
}
'const options = {
method: 'PATCH',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({status: 'confirmed'})
};
fetch('https://api.controleclinic.com.br/v1/scheduling/appointments/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.controleclinic.com.br/v1/scheduling/appointments/{id}"
payload = { "status": "confirmed" }
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text){
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"clinic_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"patient_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"professional_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"procedure_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"start_at": "<string>",
"end_at": "<string>",
"status": "scheduled",
"notes": "<string>",
"room_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"technology_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"session_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"origem": "importacao",
"created_at": "<string>",
"updated_at": "<string>"
}{
"success": false,
"error": null
}{
"error": "<string>"
}{
"error": "Insufficient scope"
}{
"error": "Not found"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "Invalid reference",
"field": "<string>",
"message": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}Agendamentos
Atualizar agendamento
Atualiza só os campos enviados: remarcar (start_at/end_at), trocar profissional, procedimento, sala ou tecnologia, ou mudar o status (scheduled, confirmed, completed, cancelled, no_show).
Mudar o status atualiza a sessão e o retorno (recall) ligados ao agendamento. Todo id informado precisa ser da clínica da chave (senão 422).
🔴 Na clínica com o Pix antecipado ligado, confirmed significa “pagou”: mudar para confirmed um agendamento que exige Pix e não pagou devolve 409. Sessão de pacote já vendido, procedimento de valor zero e agendamento criado antes de a opção ser ligada não exigem Pix.
Escopo: scheduling:write.
PATCH
/
v1
/
scheduling
/
appointments
/
{id}
Atualizar agendamento
curl --request PATCH \
--url https://api.controleclinic.com.br/v1/scheduling/appointments/{id} \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"status": "confirmed"
}
'const options = {
method: 'PATCH',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({status: 'confirmed'})
};
fetch('https://api.controleclinic.com.br/v1/scheduling/appointments/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.controleclinic.com.br/v1/scheduling/appointments/{id}"
payload = { "status": "confirmed" }
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text){
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"clinic_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"patient_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"professional_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"procedure_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"start_at": "<string>",
"end_at": "<string>",
"status": "scheduled",
"notes": "<string>",
"room_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"technology_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"session_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"origem": "importacao",
"created_at": "<string>",
"updated_at": "<string>"
}{
"success": false,
"error": null
}{
"error": "<string>"
}{
"error": "Insufficient scope"
}{
"error": "Not found"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "Invalid reference",
"field": "<string>",
"message": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}Autorizações
Token de API no formato cc_live_<64 chars hex>. Obtido em Minha Clínica → Integrações.
Parâmetros de caminho
Corpo
application/json
Resposta
Agendamento atualizado
Opções disponíveis:
scheduled, confirmed, completed, cancelled, no_show Opções disponíveis:
importacao