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

POST

chats

{id}

visibility

Error

A valid request URL is required to generate request examples

{
  "chat_id": "chat_d8aad64dib2c7m3ae7j0",
  "visibility": "restricted"
}

{
  "code": "publicapi.tenancy.project.missing",
  "humane": "X-Project-Id header is required.",
  "statusCode": 400
}

{
  "code": "publicapi.auth.invalid",
  "humane": "The provided API key is invalid or has been revoked.",
  "statusCode": 401
}

{
  "code": "publicapi.auth.invalid",
  "statusCode": 401,
  "humane": "The provided API key is invalid or has been revoked."
}

{
  "code": "publicapi.auth.invalid",
  "statusCode": 401,
  "humane": "The provided API key is invalid or has been revoked."
}

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}$

Body

application/json

visibility

enum<string>

required

Chat access level. project: every project member can read it. restricted: only the owner and the audience managed under the members sub-resource. private: owner only.

Available options:

project,

restricted,

private

Response

Visibility updated.

chat_id

string

required

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

visibility

enum<string>

required

Chat access level. project: every project member can read it. restricted: only the owner and the audience managed under the members sub-resource. private: owner only.

Available options:

project,

restricted,

private

List Chat MembersReturns the restricted chat's audience. Chat members are distinct from project members: audience membership only narrows who can read the chat and never grants project access. Only users who can update the chat may read its audience.

⌘I

Error

A valid request URL is required to generate request examples

{
  "chat_id": "chat_d8aad64dib2c7m3ae7j0",
  "visibility": "restricted"
}

{
  "code": "publicapi.tenancy.project.missing",
  "humane": "X-Project-Id header is required.",
  "statusCode": 400
}

{
  "code": "publicapi.auth.invalid",
  "humane": "The provided API key is invalid or has been revoked.",
  "statusCode": 401
}

{
  "code": "publicapi.auth.invalid",
  "statusCode": 401,
  "humane": "The provided API key is invalid or has been revoked."
}

{
  "code": "publicapi.auth.invalid",
  "statusCode": 401,
  "humane": "The provided API key is invalid or has been revoked."
}

Introduction

Chats

Assets

Labels

Actions

Sessions

Skills

Memories

Projects

Set Chat Visibility

Authorizations

Headers

Path Parameters

Body

Response