Stores the AI drawer’s conversation history. Each chat belongs to one user in one instance and holds an ordered list of prompts with the model’s responses and any generated artifacts.

Base URL: https://mcp.content.one/api. All requests and responses are JSON (Content-Type: application/json, max 1 MB body). Every response has a message; successful responses also have data.

Every endpoint requires a Zesty session token and an instance the user can access.

*The instance ZUID can also be sent as instanceZuid in the JSON body or the ?instanceZuid= query string. If more than one is sent, the body wins, then the query string, then the header. The user’s access to the instance is checked on every request.

Errors on every endpoint

Chats are stored per user and per instance: Users → Instances → Chats → Prompts. A user only ever sees their own chats in the instance they request.

Chat

Prompt

Artifact

Returns the authenticated user’s chats for the instance, most recently active first. A chat’s updatedAt is bumped whenever a prompt is added or its approval changes.

Query parameters

Example

curl https://mcp.content.one/api/chats \
  -H "Authorization: Bearer $SESSION_TOKEN" \
  -H "X-Instance-Zuid: $INSTANCE_ZUID"

Response 200

{
  "data": [ {
      "chatZuid": "51-abc123-xyz",
      "userZuid": "5-abc123-xyz",
      "instanceZuid": "8-abc123-xyz",
      "roleZuid": "30-abc123-xyz",
      "title": "Write a tagline for our homepage",
      "referer": "https://8-abc123-xyz.manager.zesty.io/content/6-abc/7-abc",
      "createdAt": "2026-10-13T17:02:11.512Z",
      "updatedAt": "2026-10-13T17:05:40.091Z",
      "deletedAt": null
    } ],
  "message": "Fetched chats successfully."
}

Starts a new, empty chat. The AI drawer usually doesn’t call this directly: POST /client creates the chat automatically on the first prompt when url and roleZuid are sent without a chatZuid.

Body

Example

curl -X POST https://mcp.content.one/api/chats \
  -H "Authorization: Bearer $SESSION_TOKEN" \
  -H "X-Instance-Zuid: $INSTANCE_ZUID" \
  -H "Content-Type: application/json" \
  -d '{"roleZuid":"30-abc123-xyz","title":"Homepage copy"}'

Response 201

{
  "data": {
    "chatZuid": "51-abc123-xyz",
    "userZuid": "5-abc123-xyz",
    "instanceZuid": "8-abc123-xyz",
    "roleZuid": "30-abc123-xyz",
    "title": "Write a tagline for our homepage",
    "referer": "https://8-abc123-xyz.manager.zesty.io/content/6-abc/7-abc",
    "createdAt": "2026-10-13T17:02:11.512Z",
    "updatedAt": "2026-10-13T17:05:40.091Z",
    "deletedAt": null
  },
  "key": "51-abc123-xyz",
  "message": "Chat created successfully."
}

Errors

Returns one chat with all of its prompts, oldest first (conversation order). Each prompt includes its artifacts.

Path parameters

Query parameters

Example

curl https://mcp.content.one/api/chats/51-abc123-xyz \
  -H "Authorization: Bearer $SESSION_TOKEN" \
  -H "X-Instance-Zuid: $INSTANCE_ZUID"

Response 200

{
  "data": {
    "chatZuid": "51-abc123-xyz",
    "title": "Write a tagline for our homepage",
    "…": "other chat fields",
    "prompts": [ {
        "promptZuid": "52-abc123-xyz",
        "chatZuid": "51-abc123-xyz",
        "instanceZuid": "8-abc123-xyz",
        "prompt": "Write a tagline for our homepage",
        "response": "\"Content that scales with you.\"",
        "metadata": { "temperature": 0.5, "tone": "Professional" },
        "url": "https://8-abc123-xyz.manager.zesty.io/content/6-abc/7-abc",
        "approval": "0",
        "artifacts": [],
        "createdAt": "2026-10-13T17:05:40.012Z",
        "updatedAt": "2026-10-13T17:05:40.012Z",
        "deletedAt": null
      } ]
  },
  "message": "Fetched 51-abc123-xyz chat successfully."
}

Errors

Appends one prompt/response exchange to a chat and bumps the chat’s updatedAt. POST /client calls this automatically when url is sent.

Path parameters

Body

Example

curl -X POST https://mcp.content.one/api/chats/51-abc123-xyz/prompt \
  -H "Authorization: Bearer $SESSION_TOKEN" \
  -H "X-Instance-Zuid: $INSTANCE_ZUID" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"Write a tagline","response":"\"Content that scales.\"","metadata":{"temperature":0.5},"url":"https://…","approval":"0","artifacts":[]}'

Response 201

{
  "data": {
    "promptZuid": "52-abc123-xyz",
    "chatZuid": "51-abc123-xyz",
    "instanceZuid": "8-abc123-xyz",
    "prompt": "Write a tagline for our homepage",
    "response": "\"Content that scales with you.\"",
    "metadata": { "temperature": 0.5, "tone": "Professional" },
    "url": "https://8-abc123-xyz.manager.zesty.io/content/6-abc/7-abc",
    "approval": "0",
    "artifacts": [],
    "createdAt": "2026-10-13T17:05:40.012Z",
    "updatedAt": "2026-10-13T17:05:40.012Z",
    "deletedAt": null
  },
  "key": "52-abc123-xyz",
  "message": "Prompt created successfully."
}

Errors

Records whether the user approved a response, and bumps the chat’s updatedAt.

Path parameters

Body

Example

curl -X PATCH https://mcp.content.one/api/chats/51-abc123-xyz/prompt/52-abc123-xyz \
  -H "Authorization: Bearer $SESSION_TOKEN" \
  -H "X-Instance-Zuid: $INSTANCE_ZUID" \
  -H "Content-Type: application/json" \
  -d '{"approval":"1"}'

Response 200

{
  "data": { "promptZuid": "52-abc123-xyz", "approval": "1", "…": "other prompt fields" },
  "message": "Prompt approval updated successfully."
}

Errors