API Reference — Manyfold

Connect in three minutes

Use the hosted API origin, create a scoped token, then send an OpenAI-compatible request where model is your Manyfold agent id.

Base URL: https://api.manyfold.ai/api/v1
Auth: Authorization: Bearer
Recommended scope: chat.completions

Create or choose an agent and copy its agt_ id.
Create an API token in Settings -> API tokens.
Call /chat/completions with Authorization: Bearer $MF_API_TOKEN.

Endpoints

The public v1 surface is intentionally small: create turns, list API-created conversations, and replay messages.

POST /api/v1/chat/completions

Create a chat completion

Start a turn with a Manyfold agent through the OpenAI-compatible Chat Completions shape.

GET /api/v1/conversations

List conversations

List non-channel conversations created through the OpenAI-compatible v1 API.

GET /api/v1/conversations/{session_id}/messages

List conversation messages

Replay messages for one API-created conversation, including text and full Manyfold content blocks.

Errors

Errors use an OpenAI-style envelope so compatible clients can handle auth and validation failures consistently.

{
    "error": {
        "message": "API token does not have chat.completions scope",
        "type": "authentication_error",
        "code": "invalid_api_key"
    }
}

Full chat guide · Conversation guide