mammoth-io · Schema

TodayView

CompanyDataAnalyticsAutomationDashboardsArtificial Intelligence

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
View JSON Schema on GitHub

JSON Schema

mammoth-io-today-view-schema.json Raw ↑
{
  "$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.
All 92 tools →

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.