Chit API Reference

Overview

/chit is the deterministic, machine- and human-readable "node information sheet" exposed over HTTP for every addressable node. It describes what the node is, what it can do, and what to expect operationally — all without relying on model inference.

For a conceptual comparison with /chat, see Chat & Chit.

Endpoints

All endpoints use GET and are relative to your node's base URL: https://YOUR-NODE-ALIAS.interlocute.ai.

Authentication

Like /chat, the /chit endpoints support API key, JWT, and anonymous access. Anonymous access must be explicitly enabled per node. See Auth & Keys for details.

Content negotiation

/chit and all sub-resources support the Accept header for content negotiation. The same semantic content is returned in different representations:

• application/json — structured JSON (default)
• text/plain — human-readable plain text
• text/markdown — formatted Markdown

No HTML or XML output is supported.

# JSON (default)
curl https://my-node.interlocute.ai/chit/identity

# Plain text
curl -H "Accept: text/plain" \
  https://my-node.interlocute.ai/chit/identity

# Markdown
curl -H "Accept: text/markdown" \
  https://my-node.interlocute.ai/chit/identity

Deterministic & inference-free

/chit output is generated entirely from typed node facts, capability flags, and persisted operator configuration. There is:

• No model inference or LLM creativity
• No reflection or dynamic property access
• Predictable, stable structure across identical configurations

This makes /chit safe for automated discovery, agent-to-agent negotiation, and governance tooling.

Verbosity

/chit supports a deterministic verbosity level: low, standard (default), or high. Higher verbosity includes more detail (descriptions, tool schemas, model parameters) without changing the fundamental structure.

Operator overrides

Each node has an optional configuration that controls each chit section:

• Enabled / disabled — a disabled sub-resource returns 404
• Mode: Standard — content is generated from node configuration (default)
• Mode: Custom — the operator provides an override body

Custom mode constraints:

• Exactly one override body per section
• Override must be text/plain or text/markdown
• The JSON representation wraps the custom text in a structured envelope

Example: /chit/identity (JSON)

{
  "nodeId": "nd_abc123",
  "name": "Support Assistant",
  "description": "Customer support node for Acme Corp",
  "model": "gpt-4o",
  "capabilities": {
    "memory": true,
    "rag": true,
    "toolUse": true,
    "streaming": true,
    "scheduling": false
  },
  "tools": ["lookup_order", "search_kb"],
  "verbosity": "standard"
}

Error responses

What /chit is NOT

• Not a per-interaction receipt — it does not log individual requests or responses
• Not a tool-call log — it does not record which tools were called during a conversation
• Not a billing line item — token usage and cost are tracked elsewhere (in the usage and observability layer)
• Not a conversation transcript — threads and messages live in the /chat surface

Forward-looking

As Interlocute evolves — particularly around long-running and deferred execution — /chit may expand to describe additional operational facets. The core design principle remains: deterministic, operator-controlled, inference-free.

Next steps

• Chat API Reference — full /chat endpoint reference
• Chat & Chit — conceptual overview of the two node surfaces
• API Examples — copy-paste starters in cURL, C#, and JavaScript