How to Create Conversations

Create a conversation with a set of documents. A conversation must be created before asking questions to documents.

Create Conversation

post

Creates a new conversation based on the document IDs.

Authorizations

ApiKeyAuth

AuthorizationstringRequired

API key provided as a Bearer token in the Authorization header.

Body

application/json

documentIdsstring · uuid[]Required

Responses

200

Successfully created a new conversation.

application/json

401

Unauthorized access, invalid API key.

application/json

429

Rate limit exceeded.

application/json

post

/v1/conversations

HTTPcURLJavaScriptPython

POST /api/v1/conversations HTTP/1.1
Host: app.humata.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 95

{
  "documentIds": [
    "63ea1432-d6aa-49d4-81ef-07cb1692f2ee",
    "cbec39d9-1e01-409c-9fc2-f19f5d01005c"
  ]
}

{
  "id": "e6d13306-c93d-466e-b239-59ca09058ce9"
}