Properties
| Name | Type | Description |
|---|---|---|
| state | string | |
| page | object | |
| updating | boolean | |
| replacing | boolean | |
| retrying | boolean | |
| quiet_since | object | |
| stale | object | |
| undated | boolean | |
| giver | object | |
| is_builder | boolean | |
| projects | array | |
| rules | array | |
| standing | array | |
| progress | array | |
| reading | array | |
| blocks | array | |
| order | string | |
| blocks_label | object | |
| since | object | |
| covers | object | |
| covers_more | integer | |
| covers_unreadable | integer | |
| alerts | array |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/mammoth-io/json-schema/mammoth-io-today-view-schema.json",
"title": "TodayView",
"x-generated": "2026-11-10",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/mammoth-io-agents-api-openapi.yml#/components/schemas/TodayView",
"properties": {
"state": {
"type": "string",
"enum": [
"page",
"writing",
"empty"
]
},
"page": {
"oneOf": [
{
"$ref": "#/$defs/TodayPage"
},
{
"type": "null"
}
]
},
"updating": {
"type": "boolean",
"default": false
},
"replacing": {
"type": "boolean",
"default": false
},
"retrying": {
"type": "boolean",
"default": false
},
"quiet_since": {
"oneOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"stale": {
"oneOf": [
{
"$ref": "#/$defs/Stale"
},
{
"type": "null"
}
]
},
"undated": {
"type": "boolean",
"default": false
},
"giver": {
"oneOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"is_builder": {
"type": "boolean",
"default": false
},
"projects": {
"items": {
"type": "string"
},
"type": "array",
"default": []
},
"rules": {
"items": {
"$ref": "#/$defs/PageRule"
},
"type": "array",
"default": []
},
"standing": {
"items": {
"$ref": "#/$defs/Standing"
},
"type": "array",
"default": []
},
"progress": {
"items": {
"$ref": "#/$defs/ProgressStep"
},
"type": "array",
"default": []
},
"reading": {
"items": {
"type": "string"
},
"type": "array",
"default": []
},
"blocks": {
"items": {
"$ref": "#/$defs/BlockView"
},
"type": "array",
"default": []
},
"order": {
"type": "string",
"enum": [
"lift",
"unusual",
"arranged"
],
"default": "lift"
},
"blocks_label": {
"oneOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"since": {
"oneOf": [
{
"$ref": "#/$defs/Since"
},
{
"type": "null"
}
]
},
"covers": {
"oneOf": [
{
"$ref": "#/$defs/Covers"
},
{
"type": "null"
}
]
},
"covers_more": {
"type": "integer",
"default": 0
},
"covers_unreadable": {
"type": "integer",
"default": 0
},
"alerts": {
"items": {
"$ref": "#/$defs/AlertNotice"
},
"type": "array",
"default": []
}
},
"type": "object",
"required": [
"state"
],
"$defs": {
"AlertNotice": {
"properties": {
"alert_id": {
"type": "string"
},
"name": {
"type": "string"
},
"text": {
"type": "string"
},
"at": {
"type": "string"
}
},
"type": "object",
"required": [
"alert_id",
"at",
"name",
"text"
],
"title": "AlertNotice"
},
"BlockAnswer": {
"properties": {
"answered": {
"type": "boolean"
},
"label": {
"type": "string",
"default": ""
},
"text": {
"type": "string",
"default": ""
},
"items": {
"items": {
"type": "string"
},
"type": "array",
"default": []
},
"columns": {
"items": {
"type": "string"
},
"type": "array",
"default": []
},
"rows": {
"items": {
"items": {
"oneOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "integer"
},
{
"type": "null"
}
]
},
"type": "array"
},
"type": "array",
"default": []
},
"chart": {
"oneOf": [
{
"$ref": "#/$defs/BlockChart"
},
{
"type": "null"
}
]
},
"file_id": {
"oneOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"written_at": {
"type": "string",
"default": ""
},
"proof": {
"oneOf": [
{
"$ref": "#/$defs/BlockProof"
},
{
"type": "null"
}
]
},
"usual": {
"oneOf": [
{
"$ref": "#/$defs/BlockUsual"
},
{
"type": "null"
}
]
},
"history": {
"items": {
"oneOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"type": "array",
"default": []
},
"facts_used": {
"items": {
"type": "string"
},
"type": "array",
"default": []
},
"planned_at": {
"type": "string",
"default": ""
},
"headline": {
"oneOf": [
{
"$ref": "#/$defs/BlockHeadline"
},
{
"type": "null"
}
]
},
"verified": {
"type": "boolean",
"default": false
}
},
"type": "object",
"required": [
"answered"
],
"title": "BlockAnswer"
},
"BlockChart": {
"properties": {
"kind": {
"type": "string",
"enum": [
"bar",
"line"
],
"default": "bar"
},
"labels": {
"items": {
"type": "string"
},
"type": "array"
},
"values": {
"items": {
"oneOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"type": "array"
},
"measure": {
"type": "string"
},
"periods": {
"items": {
"type": "string"
},
"type": "array",
"default": []
},
"grain": {
"oneOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"partial": {
"type": "boolean",
"default": false
},
"adds": {
"type": "boolean",
"default": false
}
},
"type": "object",
"required": [
"labels",
"measure",
"values"
],
"title": "BlockChart"
},
"BlockCheck": {
"properties": {
"by": {
"type": "string"
},
"at": {
"type": "string"
},
"current": {
"type": "boolean"
}
},
"type": "object",
"required": [
"at",
"by",
"current"
],
"title": "BlockCheck"
},
"BlockHeadline": {
"properties": {
"value": {
"type": "number"
},
"period": {
"type": "string"
},
"grain": {
"type": "string"
},
"measure": {
"type": "string"
},
"change": {
"oneOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"so_far": {
"type": "boolean",
"default": false
},
"worse_up": {
"type": "boolean",
"default": false
}
},
"type": "object",
"required": [
"grain",
"measure",
"period",
"value"
],
"title": "BlockHeadline"
},
"BlockProof": {
"properties": {
"file_id": {
"type": "integer"
},
"file_name": {
"type": "string"
},
"project_name": {
"type": "string"
},
"rows_read": {
"oneOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"query": {
"type": "string"
},
"sql": {
"oneOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"view_id": {
"oneOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"figure": {
"oneOf": [
{
"additionalProperties": {},
"type": "object"
},
{
"type": "null"
}
]
}
},
"type": "object",
"required": [
"file_id",
"file_name",
"project_name",
"query"
],
"title": "BlockProof"
},
"BlockUsual": {
"properties": {
"group": {
"type": "string"
},
"period": {
"type": "string"
},
"latest": {
"type": "number"
},
"usual": {
"type": "number"
},
"times_usual": {
"type": "number"
},
"measure": {
"type": "string"
},
"grain": {
"type": "string"
},
"periods": {
"type": "integer"
},
"rate": {
"type": "boolean",
"default": false
},
"worse_up": {
"type": "boolean",
"default": false
},
"in_numbers": {
"oneOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "\"24 vs usual 4\": what the chip says in place of a percentage when a count's\nusual is under :data:`SMALL_USUAL` (Gaurav 10-28); None when a percentage reads\nfine.",
"readOnly": true
}
},
"type": "object",
"required": [
"grain",
"group",
"latest",
"measure",
"period",
"periods",
"times_usual",
"usual"
],
"title": "BlockUsual"
},
"BlockView": {
"properties": {
"id": {
"type": "string"
},
"about": {
"type": "string"
},
"shape": {
"type": "string",
"enum": [
"words",
"chart",
"table",
"list"
]
},
"state": {
"type": "string",
"enum": [
"ready",
"writing",
"failed"
]
},
"answer": {
"oneOf": [
{
"$ref": "#/$defs/BlockAnswer"
},
{
"type": "null"
}
]
},
"only_when": {
"oneOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"quiet": {
"type": "boolean",
"default": false
},
"place": {
"type": "integer",
"default": 0
},
"moved_from": {
"oneOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"checked": {
"oneOf": [
{
"$ref": "#/$defs/BlockCheck"
},
{
"type": "null"
}
]
},
"used_facts": {
"items": {
"$ref": "#/$defs/Fact"
},
"type": "array",
"default": []
},
"left_out": {
"type": [
"null",
"string"
],
"enum": [
"failed",
"empty",
"repeats",
null
]
},
"repeats": {
"oneOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"type": "object",
"required": [
"about",
"id",
"shape",
"state"
],
"title": "BlockView"
},
"Covers": {
"properties": {
"column": {
"type": "string"
},
"start": {
"type": "string"
},
"end": {
"type": "string"
},
"step": {
"type": [
"null",
"string"
],
"enum": [
"day",
"week",
"month",
"quarter",
"year",
null
]
},
"planned_to": {
"oneOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"ended": {
"type": "boolean",
"default": false
}
},
"type": "object",
"required": [
"column",
"end",
"start"
],
"title": "Covers"
},
"Fact": {
"properties": {
"id": {
"type": "string",
"maxLength": 24,
"default": ""
},
"text": {
"type": "string",
"maxLength": 300,
"minLength": 1
},
"source": {
"type": "string",
"enum": [
"setup",
"chat",
"edit",
"questions"
],
"default": "edit"
},
"at": {
"type": "string",
"maxLength": 40,
"default": ""
},
"guess": {
"type": "boolean",
"default": false
},
"why": {
"type": "string",
"maxLength": 200,
"default": ""
},
"about": {
"type": "string",
"maxLength": 300,
"default": ""
},
"snoozed_until": {
"type": "string",
"maxLength": 40,
"default": ""
},
"snoozes": {
"type": "integer",
"default": 0
}
},
"type": "object",
"required": [
"text"
],
"title": "Fact"
},
"PageAlso": {
"properties": {
"label": {
"type": "string",
"maxLength": 24,
"minLength": 2,
"description": "Watch, Steady, Covers, Over time…"
},
"number": {
"oneOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The number it shows: n4"
},
"text": {
"type": "string",
"maxLength": 180,
"minLength": 3
},
"about": {
"type": "string",
"maxLength": 80,
"minLength": 2
},
"id": {
"type": "string"
}
},
"type": "object",
"required": [
"about",
"id",
"label",
"text"
],
"title": "PageAlso"
},
"PageLine": {
"properties": {
"text": {
"type": "string",
"maxLength": 420,
"minLength": 3,
"description": "One or two sentences; every figure a {n1} token"
},
"about": {
"type": "string",
"maxLength": 80,
"minLength": 2,
"description": "What it is about, in a few words: 'operating margin'"
},
"project": {
"oneOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Its project's name, on a page about several"
},
"id": {
"type": "string"
}
},
"type": "object",
"required": [
"about",
"id",
"text"
],
"title": "PageLine"
},
"PageRule": {
"properties": {
"kind": {
"type": "string",
"enum": [
"lead",
"always",
"less",
"hide"
]
},
"about": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"source": {
"type": "string",
"enum": [
"chat",
"edit"
],
"default": "edit"
}
},
"type": "object",
"required": [
"about",
"kind"
],
"title": "PageRule"
},
"ProgressStep": {
"properties": {
"key": {
"type": "string",
"enum": [
"read",
"find",
"write"
]
},
"started_at": {
"oneOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"finished_at": {
"oneOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"type": "object",
"required": [
"key"
],
"title": "ProgressStep"
},
"ShownNumber": {
"properties": {
"value": {
"type": "string"
},
"series": {
"oneOf": [
{
"items": {
"type": "number"
},
"type": "array"
},
{
"type": "null"
}
]
},
"change": {
"oneOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"direction": {
"type": [
"null",
"string"
],
"enum": [
"up",
"down",
"flat",
null
]
},
"qualifier": {
"oneOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"bad": {
"type": "boolean",
"default": false
},
"question": {
"type": "string"
}
},
"type": "object",
"required": [
"question",
"value"
],
"title": "ShownNumber"
},
"Since": {
"properties": {
"weekday": {
"type": "string"
},
"text": {
"type": "string"
}
},
"type": "object",
"required": [
"text",
"weekday"
],
"title": "Since"
},
"Stale": {
"properties": {
"as_of": {
"type": "string"
},
"days": {
"type": "integer"
},
"usual": {
"type": "string"
}
},
"type": "object",
"required": [
"as_of",
"days",
"usual"
],
"title": "Stale"
},
"Standing": {
"properties": {
"pin_id": {
"type": "integer"
},
"title": {
"type": "string"
}
},
"type": "object",
"required": [
"pin_id",
"title"
],
"title": "Standing"
},
"TodayPage": {
"properties": {
"id": {
"type": "string"
},
"written_at": {
"type": "string"
},
"data_label": {
"oneOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"projects": {
"items": {
"type": "string"
},
"type": "array"
},
"headline": {
"type": "string"
},
"lines": {
"items": {
"$ref": "#/$defs/PageLine"
},
"type": "array"
},
"also": {
"items": {
"$ref": "#/$defs/PageAlso"
},
"type": "array"
},
"numbers": {
"additionalProperties": {
"$ref": "#/$defs/ShownNumber"
},
"type": "object"
},
"next_expected": {
"oneOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"last_day": {
"oneOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"grain": {
"oneOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"type": "object",
"required": [
"also",
"headline",
"id",
"lines",
"numbers",
"projects",
"written_at"
],
"title": "TodayPage"
}
}
}
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/mammoth-io-today-view"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.