assistant
GET /v1/assistant/conversations/{conversationId}
Read one conversation with its full thread.
Autentifikacija
Pošaljite API ključ kao bearer token. Ova krajnja točka ne navodi određenu dozvolu u specifikaciji, stoga dajte svom ključu najmanje što mu je potrebno i provjerite odgovor umjesto da pretpostavljate.
Ova krajnja točka ne prihvaća ID organizacije. Vaš ključ već identificira organizaciju kojoj pripada, a odgovor je ograničen na nju.
Isprobajte
Zamijenite sve unutar šiljastih zagrada svojim vlastitim vrijednostima, a rezervirano mjesto za ključ s ključem iz vaše nadzorne ploče.
curl -X GET https://api.zinndigital.com/v1/assistant/conversations/{conversationId} \
-H "Authorization: Bearer zdk_live_…"Prijavljeni ste? API konzola na vašoj nadzornoj ploči automatski unosi stvarni ID vaše organizacije i vaš vlastiti ključ te šalje zahtjev prema aktivnom API-ju kako biste mogli vidjeti stvarni odgovor. Otvori ovu krajnju točku u API konzoli
Pojedinosti
⛔ A colleague's conversation is a `404`, never a `403` — a `403` confirms the id exists, which is itself information about what a colleague has asked.
Parametri
| Naziv | Vrsta | Obavezno | Što je to |
|---|---|---|---|
conversationId (path) | Uuid | Da | The conversation's id. |
Odgovor
| Naziv | Vrsta | Obavezno | Što je to |
|---|---|---|---|
id | Uuid | Da | UUIDv7 identifier — sortable by creation time (docs/02 §8). |
title | string | Da | The first question, truncated, so a list of threads is readable. |
escalated_ticket_id | Uuid | Da | Set once this thread became a support ticket. |
created_at | string | Da | — |
updated_at | string | Da | — |
messages | AssistantMessage[] | Da | — |
proposals | AgentProposal[] | Da | Actions the assistant suggested in this thread. **Nothing here has happened** — a proposal is a suggestion with a confirm button, and it is applied only by `POST /v1/ai/proposal… |
Pogreške koje ova krajnja točka može vratiti
401 · 403 · 404 · 429