---
title: "POST /v1/org/{org_id}/chat"
method: POST
path: "/v1/org/{org_id}/chat"
tags: ["lance.chat"]
---

# POST /v1/org/{org_id}/chat

`POST /v1/org/{org_id}/chat`

## Request

- Base URL: `https://api.lance.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.lance.app/v1/org/{org_id}/chat`
- Auth: HTTP bearer

## Path parameters

- `org_id` string, required: a string matching the pattern ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$

## Request body

- object
  - `message` string, required: a string at most 8000 character(s) long
  - `bundle_id` string
  - `thread_id` string
  - `authorize` string[]: Structured authorization for irreversible App Store actions this ask requests. The App Manager performs them ONLY when an ask it is working on carries the matching value; without it, it stops at submit-ready and replies with how to authorize. Pass a value only when the human owner approved that action (saying it in the message is not enough). "submit_for_review": submit the app's App Store version (and anything staged in the same review submission) to App Review. "release": release an approved App Store version to the public (a release request), or start, resume or complete a phased release. "cancel_submission": withdraw a review submission that is waiting for or in App Review (App Store Connect then shows the version as Developer Rejected). It covers the operator turn that works on this ask, never a later one (a new or resumed turn needs a new authorized ask), and on an app's thread (bundle_id) that app only. A re-ask that adds authorization is a new ask (where the ask takes an idempotency_key, use a new idempotency_key).

## Response `202`

Success

- object
  - `accepted_at` string, required
  - `org_id` string, required
  - `bundle_id` string, nullable, required
  - `thread_id` string, required
  - `note` string, required
  - `authorize` string[]

## Other responses

- `400`: The request did not match the expected schema
- `401`: Error
- `402`: Error
- `403`: Error
- `429`: Error
- `500`: Unauthorized

---

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