---
title: "Start a new AI chat with an initial message or question"
method: POST
path: "/v1/org/{orgId}/ai/chat"
tags: ["ai"]
---

# Start a new AI chat with an initial message or question

`POST /v1/org/{orgId}/ai/chat`

## Path parameters

- `orgId` string, required

## Request body

- AiChatRequest
  - `message` string, required
  - `label` string
  - `initialAiMessage` string
  - `initialAiMessageAt` string
  - `dataContext` 'ASSESSMENT' | 'ASSESSMENT_CALIBRATE' | 'COMP_REVIEW' | 'PERSON_COMMON' | 'DASHBOARD' | 'FORM_COMPLETE' | 'GOAL' | 'SCENARIO' | 'SCENARIO_IMPACT' | 'TRANSCRIPT' | 'PROCESS_LOG'
  - `dataContextParams` object
  - `url` string, uri
  - `channel` 'WEB' | 'MOBILE' | 'SLACK' | 'TEAMS' | 'MCP'
  - `agentUserId` string
  - `fileIds` string[]

## Response `201`

successful operation

## Other responses

- `400` — invalid data
- `401` — not authorized
- `403` — permission denied
- `404` — not found

---

[API](https://skmtc.net/charthop/apis/charthop-api.md) · [All operations](https://skmtc.net/charthop/apis/charthop-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/charthop/charthop-api/versions/50a1edd6b27e/schema)