---
title: "[BETA] Create workspace agent session"
method: POST
path: "/agent/sessions"
tags: ["agent"]
---

# [BETA] Create workspace agent session

`POST /agent/sessions`

Create a new agent session.

## Request body

- object
  - `title` string — Session title; defaults to Untitled if omitted
  - `company_id` string — Optional company UUID (scoped session)
  - `type` 'document' | 'chat' | 'plan' | 'canvas_settings' | 'email' | 'workspace' | 'project' — Session type; defaults to chat if missing or invalid

## Response `201`

Created

- object — Response data

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `500` — Unexpected error

---

[API](https://skmtc.net/getpg/apis/pg-ai-public-api.md) · [All operations](https://skmtc.net/getpg/apis/pg-ai-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getpg/pg-ai-public-api/revisions/cc47d013c073/schema)