curl -X POST https://api.vouchmark.com/v1/chat/new \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"companyId": "cmp_aBcD..."}'
{
"message": "Chat created successfully",
"chat": {
"id": "chat_aBcD...",
"title": "TEKCIFY TECHNOLOGIES LTD - 6/27/2026",
"companyId": "cmp_aBcD...",
"messages": []
}
}
Vouch AI
Start new chat
Create or return the Vouch AI chat for a company.
POST
/
v1
/
chat
/
new
curl -X POST https://api.vouchmark.com/v1/chat/new \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"companyId": "cmp_aBcD..."}'
{
"message": "Chat created successfully",
"chat": {
"id": "chat_aBcD...",
"title": "TEKCIFY TECHNOLOGIES LTD - 6/27/2026",
"companyId": "cmp_aBcD...",
"messages": []
}
}
Returns the Vouch AI chat for a company, creating it if one does not yet exist. Each user has a single persistent chat per company. No first message is sent here — use Send message to talk to the AI.
A brand-new chat returns
Vouch AI requires a positive wallet balance and is metered per AI request. Conversation turns are billed at ₦100 per 1,000 tokens. Requests are rejected if the wallet balance is not positive, and rate limited to 10 AI requests per minute.
Body
string
required
The company the chat is scoped to.
curl -X POST https://api.vouchmark.com/v1/chat/new \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"companyId": "cmp_aBcD..."}'
{
"message": "Chat created successfully",
"chat": {
"id": "chat_aBcD...",
"title": "TEKCIFY TECHNOLOGIES LTD - 6/27/2026",
"companyId": "cmp_aBcD...",
"messages": []
}
}
201 Created with an empty messages array. If a chat already exists for the company, the response is 200 OK and includes the existing messages plus a top-level chatId:
{
"success": true,
"message": "A chat already exists for this company",
"chat": {
"id": "chat_aBcD...",
"title": "TEKCIFY TECHNOLOGIES LTD - 6/27/2026",
"companyId": "cmp_aBcD...",
"messages": [
{
"id": "msg_aBcD...",
"chatId": "chat_aBcD...",
"sender": "user",
"content": "What are my compliance risks?",
"timestampAt": "2026-06-27T10:00:00Z",
"groundingSources": null
}
]
},
"chatId": "chat_aBcD..."
}