Circlio API

Zarządzanie grupami przez API

Pełny odczyt i zapis grup kontaktów, celów rozmów i importu list — przez ten sam osobisty token API, który obsługuje resztę squeevio.com.Full read/write access to contact groups, call goals, and list import — through the same personal API token that powers the rest of squeevio.com.

Uwierzytelnianie / Authentication

Wygeneruj token w panelu (/api-tokens) z uprawnieniami orbio_read/orbio_write, zobacz pełną dokumentację uwierzytelniania i zakresów squeevio.Generate a token in the panel (/api-tokens) with the orbio_read/orbio_write scopes — see squeevio's full authentication and scopes reference.

Authorization: Bearer skz_...

Endpointy / Endpoints

GET/api/v1/orbio/groupsorbio_read

Pełny odczyt: grupy, grupy udostępnione, cele rozmów, awatary, preferencje połączeń per kontakt. Ta odpowiedź TO eksport — nie ma osobnego endpointu eksportu.Full read: groups, shared groups, call goals, avatars, per-contact call prefs. This response IS the export — there is no separate export endpoint.

PUT/api/v1/orbio/groupsorbio_write

Zapis pełnej zamiany (nie scalanie) — pobierz aktualny stan przez GET, zmodyfikuj, odeślij cały stan z powrotem.Full-replace write (not a merge) — fetch the current state via GET, modify it, send the complete state back.

POST/api/v1/orbio/parse-contactsorbio_write

Bezstanowy import: wklejony tekst lub plik CSV/XLSX → [{name, phone}]. Wynik scalasz z grupą przez PUT powyżej.Stateless import: pasted text or a CSV/XLSX file → [{name, phone}]. Merge the result into a group via the PUT above.

Przykład / Example

Pełny odczyt grup (to samo, co eksport):Full read of your groups (this is also your export):

curl https://api.squeevio.com/api/v1/orbio/groups
  -H "Authorization: Bearer skz_..."

Import z pliku CSV:Importing from a CSV file:

curl -X POST https://api.squeevio.com/api/v1/orbio/parse-contacts
  -H "Authorization: Bearer skz_..."
  -F "file=@contacts.csv"

Limity / Limits: 100 grup, 100 celów rozmów, 5000 preferencji połączeń, 5000 awatarów na konto. Nieprawidłowy wpis zwraca 400 z polem index wskazującym dokładnie który element listy zawiódł.
100 groups, 100 call goals, 5000 call prefs, 5000 avatars per account. A malformed entry returns 400 with an index field naming exactly which list entry failed.