Scegliere il calendario o l'import degli impegni occupati
calendarId sceglie il calendario su cui Tako lavora (uno di GET …/calendars): le prenotazioni CONFIRMED/PENDING future del fornitore vengono scritte lì in modo asincrono e da lì ogni modifica segue; cambiandolo, gli eventi già scritti sul calendario precedente restano. Con importBusy gli impegni occupati del calendario scelto chiudono i prodotti attivi del fornitore (blocchi con calendarConnectionId, aggiornati ogni 5 minuti); importBusy false rimuove subito i blocchi importati.
/api/v1/calendar/connections/{id}Authorization
Path
Body
curl -X PATCH "https://api.takoconnect.com/api/v1/calendar/connections/{id}" \
-H "Authorization: Bearer $TAKO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"calendarId": "primary"
}'{
"id": "entity-id",
"tenantId": "tenant-id",
"supplierId": "supplier-id",
"provider": "provider",
"accountEmail": "accountEmail",
"calendarId": "calendar-id",
"importBusy": true,
"status": "ACTIVE",
"lastSyncedAt": "2030-06-15T08:00:00.000Z",
"lastError": "lastError",
"createdAt": "2030-06-15T08:00:00.000Z",
"updatedAt": "2030-06-15T08:00:00.000Z"
}Autorizzazione
AuthorizationBearer <token>
Chiave tenant emessa dalla dashboard o da POST /api-keys, usata come Bearer token.
Scope richiesti: channels:write
In: header
Parametri di percorso
idstring
Body
Content-Type: application/json
importBusy?boolean
calendarId?string
minLength 1
Risposte
200object
Operazione riuscita. Lo schema descrive il JSON restituito.
Mostra schema
idstring
tenantIdstring
supplierIdstring
providerstring
accountEmailstring | null
calendarIdstring | null
Il calendario Google su cui Tako lavora; null finché non viene scelto.
importBusyboolean
statusenum
ACTIVEDISABLED
lastSyncedAtdatetime | null
date-time
lastErrorstring | null
createdAtdatetime
date-time
updatedAtdatetime
date-time
400object
Validazione o regola di dominio non soddisfatta; correggere la richiesta.
401object
Credenziale assente, revocata, scaduta o non valida.
403object
Scope, ruolo o tipo di credenziale non consentito.
404object
Risorsa assente o non accessibile nel perimetro risolto.
409object
Conflitto di stato, capacità, versione o riferimenti; rileggere lo stato e correggere.
413object
Corpo JSON oltre il limite di 15 MB.
500object
Errore interno. Prima di ripetere una mutazione verificarne l'esito.