---
title: "Create or continue a public Agent session"
method: POST
path: "/v5/agent"
tags: ["Agent"]
---

# Create or continue a public Agent session

`POST /v5/agent`

## Request

- Base URL: `https://api.kadoa.com`
- URL: `https://api.kadoa.com/v5/agent`
- Auth: none declared

Creates a draft workflow-backed Assistant session. Explicit productType=realtime dispatches the Julie realtime lane after realtime notification settings are provisioned.

## Request body

- AgentPromptRequest
  - `prompt` string, required
  - `sessionId` string, uuid, nullable
  - `newSessionId` string, uuid, nullable
  - `threadId` string, uuid, nullable
  - `questionsDisabled` boolean
  - `templateId` string, uuid, nullable
  - `templateVersion` integer, nullable
  - `productType` 'workflow' | 'realtime'
  - `tags` string[]
  - `notificationChannelIds` string[]

## Response `202`

Agent prompt accepted

- AgentPromptResponse
  - `data` object, required
    - `jobId` string, nullable, required
    - `inputEventId` string
    - `sessionId` string, uuid, required
    - `threadId` string, uuid, required
    - `workflowId` string, uuid, required
    - `existed` boolean
  - `status` 'success', required
  - `message` string, required

## Other responses

- `400`: Invalid request body or realtime notification settings
- `403`: Authenticated user cannot create workflows for the active team
- `404`: Template, Assistant session, or thread not found
- `409`: Agent prompt conflicts with the requested context

---

[API](https://skmtc.dev/kadoa/apis/kadoa-api.md) · [All operations](https://skmtc.dev/kadoa/apis/kadoa-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kadoa/apis/kadoa-api/revisions/bf7803c927b4?raw)