Voice

Create a knowledge collection

Create an empty collection for an agent to retrieve from.

Voice takes name and description as QUERY parameters. They are a JSON body here because a description is prose - putting it in a URL means length limits and encoding bugs for the one field most likely to contain a newline. The bounds are voice's own.

post/voice/collections

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/voice/collections
  • Auth: HTTP bearer

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

namestring required

Collection name.

descriptionstring nullable

What this collection holds.

Response

Successful Response

dataVoicePayload required

One voice object - a collection, an agent, a route, a chat.

Open-shaped: voice adds fields to these bodies on its own release cadence and a dropped-or-added key must not be a 500 in this service.

Changes

No recorded changes to this operation across all 2 revisions of this API.