Skip to main content
Base path: /v1/ai/chat Use POST /v1/ai/generate/chat to send messages with access to your visibility data, traffic metrics, and documents. Use these routes to manage session history.
MethodEndpointDescription
GET/sessionsList chat sessions
GET/sessionGet session (query params)
POST/sessionCreate session. Body: { "sessionId": "optional-id" }
GET/session/:sessionIdGet session by ID
DELETE/session/:sessionIdDelete session
POST/brand-voiceGenerate brand voice
GET/getFineTuningJobFine-tuning job status
POST/feedbackSession feedback
PUT/brandVoices/:idUpdate brand voice
DELETE/brandVoices/:idDelete brand voice

​
Workspace context

Set useWorkspaceContext: true (the default) when calling POST /v1/ai/generate/chat to include visibility scores, report recommendations, and workspace documents in the assistant’s context. Check available context first with GET /v1/ai/generate/assistant/context.

​
Create a session

curl -X POST https://api.krastie.ai/v1/ai/chat/session \
  -H "Content-Type: application/json" \
  -H "api-key: krastie_YOUR_KEY" \
  -d '{"sessionId": "visibility-review-1"}'
Response (201): 
{
  "message": "Chat session created successfully.",
  "sessionId": "visibility-review-1",
  "session": {}
}

​
List sessions

curl https://api.krastie.ai/v1/ai/chat/sessions \
  -H "api-key: krastie_YOUR_KEY"

​
Ask about visibility

Pass the sessionId from an existing or newly created session to POST /v1/ai/generate/chat: 
curl -X POST https://api.krastie.ai/v1/ai/generate/chat \
  -H "Content-Type: application/json" \
  -H "api-key: krastie_YOUR_KEY" \
  -d '{
    "text": "What are my top AI visibility gaps and which prompts should I target first?",
    "model": "gpt-4o",
    "sessionId": "visibility-review-1",
    "useWorkspaceContext": true
  }'