Spaces

What is a jSON?

JSON is a simple, tidy way of writing information as labelled items so that both people and programs can read it.

In plain words

A paper form has labels and answers: Name, Anna. Phone, a number. JSON writes information down in just that way, with a label next to each value, in a neat and predictable layout.

Because every program can read it, JSON became the common language of the internet. When one service answers another, it very often does so in JSON. A list of chats, a single message and an error all come back as labelled items.

You can read it too. A message might show a text label with the words someone wrote, a time label and a sender label. You do not need to learn the rules.

If you ever look at a raw answer, the labels explain what each part is.

AI agents are good at JSON. They read it, pick out what matters and turn it into plain sentences for you. That is why you usually see a friendly summary and not the raw form.

How it works in Spaces

Spaces answers in JSON, both on the REST API and in MCP tool results. Events, webhook bodies, usage rows and errors all use it.

Every refusal has a code, an error message and a doc_url, which links to a page that explains the code and what to do. Usage can also be exported as CSV or JSON.

Related terms

FAQ

Do I have to write JSON?

No. Your AI agent or your developer does. You only ever need to read it, if you want to.

Why does my agent not show me the raw JSON?

It turns it into plain sentences, which is usually what you want.

Can I get my usage in a spreadsheet?

Yes. Usage can be exported as CSV, or as JSON.

Useful next: API reference, Errors explained, Docs. Every term: the glossary.