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
- REST API: A REST API is a way for software to talk to a service by sending ordinary web requests to named addresses and getting answers back.
- API: An API, or application programming interface, is a set of rules that lets one piece of software ask another to do something, such as send a message or list your conversations.
- Endpoint: An endpoint is one specific web address on a service that does one particular job, such as listing your chats or sending a reply.
- Webhook: A webhook is a message one service sends automatically to another's web address the moment something happens, such as a new customer message arriving.
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.