Build on Chief — MCP server, REST API, and CLI

GET

chats

{id}

Error

A valid request URL is required to generate request examples

{
  "is_shared": true,
  "url": "https://chief.bot/shared/chat/3f9c2e7a1b...",
  "created_at": "2026-05-23T10:15:30Z"
}

Authorizations

X-API-Key

string

header

required

Personal Access Token, sent verbatim as pat_<32 chars>. PATs are minted from the Chief settings UI.

Headers

X-Project-Id

string

required

Project identifier scoping the request. Required on every project-scoped public endpoint. Missing or malformed values respond with HTTP 400 and code publicapi.tenancy.project.missing.

Pattern: ^project_[a-z0-9]{20}$

Path Parameters

string

required

Chat identifier.

Pattern: ^chat_[a-z0-9]{20}$

Response

Share-link status.

is_shared

boolean

required

url

string<uri>

Public URL of the shared conversation. Anyone with this URL can read the chat without authentication. Omitted when not shared.

created_at

string<date-time>

When the active link was created. Omitted when not shared.

Create Share LinkCreates the chat's public share link. Anyone with the URL can read the conversation without authentication. Each chat has at most one active link. When an active link already exists and `regenerate` isn't set, the existing link is returned with `200` instead of an error. Pass `?regenerate=true` to revoke the current link and mint a new URL.

⌘I

Error

A valid request URL is required to generate request examples

{
  "is_shared": true,
  "url": "https://chief.bot/shared/chat/3f9c2e7a1b...",
  "created_at": "2026-05-23T10:15:30Z"
}

Introduction

Chats

Assets

Labels

Actions

Sessions

Skills

Memories

Projects

Retrieve Share Link

Authorizations

Headers

Path Parameters

Response