Changelog

A running log of API changes, additions, and deprecations.

v0.7.0 Beta

  • New
    Summaries for image objects
    GET /objects GET /objects/:id

    Image objects now carry an AI-generated summary, the same field already present on other object types.

  • New
    Object embeddings
    GET /objects GET /objects/:id

    Objects can now carry an embeddings array of ObjectEmbedding — each a vector of 32-bit floats (up to 3,072 dimensions) and its modelId. Omitted by default; request it with ?include=embeddings on List objects or Get an object.

  • New
    Mark an object complete
    PATCH /objects/:id

    Update an object accepts a completed boolean — mark an object done, or pass false to clear it.

  • New
    Create notes with an object
    POST /objects

    Create an object accepts a notes array of ObjectNotes — attach notes at creation instead of following up with Create an object note.

  • New
    Create a space with objects
    POST /spaces

    Create a space accepts an objects array of SpaceObject references — populate a new space in one call instead of adding objects one at a time.

Introducing entities

  • Breaking
    Objects expose a single mainEntity
    GET /objects && GET /objects/:id

    The entities array is replaced by a single mainEntity of type Entity. If you're relying on the undocumented object.entityType property, migrate to mainEntity.@type as soon as possible — that property is being removed imminently.

  • New
    Richer mainEntity details

    An object's mainEntity now exposes details for Book, InstagramReel, Movie, Product, Repository, TVEpisode, VideoGame, and XPost — with more types and richer data to come in releases ahead. The data is your copy, for personal use only.

v0.6.0 Alpha

  • New
    Date range filters in query syntax
    GET /search GET /objects

    Three new q fields — created, bumped, and published — accept an IsoDateTimeRange (year 2026, month 2025-02, or an instant + IsoDuration like 2026-03-01T04:15:00Z/P7D). Works anywhere the query syntax is accepted, including /objects?q=….

  • New
    Stream link, tag, and space results
    GET /links GET /tags GET /spaces

    Set Accept: application/jsonl to stream every matching link, tag, or space as newline-delimited JSON — matching the behavior previously added for /objects.

  • New
    BlobReference.name

    BlobReference gains an optional name field — the original file name as set at creation time. Captured from the filename parameter of the multipart blob part's Content-Disposition header when an object is created via POST /objects.

v0.5.0 Alpha

  • New
    List links
    GET /links

    New Links resource. Walk the graph between objects — each link has a sourceId, a targetId, and a type (WikiLink for inferred wiki-style references in note content, Manual for user-created).

  • New
    Create a link
    POST /links

    Create a Manual link between two objects. Returns { id } — 201 Created for a new link, 200 OK if an identical link already exists.

  • New
    Delete a link
    DELETE /links/:id

    Remove a Manual link by ID. WikiLink deletes return 422 — to remove one, edit the source note and delete the corresponding [[…]] reference.

  • New
    Stream object results
    GET /objects

    Set Accept: application/jsonl to stream every matching object as newline-delimited JSON. Returns all results by default.

  • Breaking
    Object entity renamed and pluralized

    Object.entity is now Object.entities and is an array of Entity — objects can carry more than one associated entity.

v0.4.0 Alpha

  • New
    Get object screenshot
    GET /objects/:id/screenshot

    Returns the screenshot captured at save time (typically the rendered view of a saved web page). Mirrors the behavior of /blob — may 302-redirect to a CDN URL.

  • New
    Object summary
    PATCH /objects/:id

    Object responses now include a summary field — a short, user-editable description. Set or refine it via Update an object.

  • New
    Object blob

    Object responses now include a blob field — a BlobReference describing the underlying media. Image blobs also carry a Palette of their dominant colors.

  • New
    Object screenshot

    Object responses now include a screenshot field — a BlobReference describing the underlying media. May also be retrieved directly via GET /objects/:id/screenshot.

  • New
    Create an object note
    POST /objects/:objectId/notes

    Append a new note to the object's notes array. Accepts text/markdown or application/prose+json via Content-Type and returns the new note's id.

  • New
    Update an object note
    PUT /objects/:objectId/notes/:noteId

    Full replace of an existing note's body. Accepts text/markdown or application/prose+json.

  • New
    Delete an object note
    DELETE /objects/:objectId/notes/:noteId

    Remove a note from an object.

v0.3.0 Alpha

  • New
    Remove object tags
    DELETE /objects/:id/tags

    Body is an array of tag references by name or id.

  • New
    Filter objects by space
    GET /objects

    New spaceId query parameter restricts results to a single space.

  • New
    Find related objects
    GET /objects

    New similarTo query parameter ranks results by similarity to a given ID. Mastermind only.

  • Docs Added SDK reference docs with copy-paste starter clients in JavaScript, Python, Ruby, PHP, C#, and Swift.
  • New Spun up the mymindcorp/api project on GitHub, where the official reference SDKs are being built in the open. Work in progress — contributions welcome.

v0.2.0 Alpha

  • Breaking
    Find related objects moved to Search
    GET /objects/:id/related → GET /search?similarTo=:objectId
  • Breaking
    Get object blob renamed
    GET /objects/:id/blob

    Was /download; renamed for symmetry with creation.

  • New
    Get object thumbnail
    GET /objects/:id/thumbnail

    New size query parameter is a bounding box, defaults to contain behavior (matches CSS).

  • New
    Inline content conversion
    GET /objects, GET /objects/:id

    New contentAs=text/markdown auto-converts object.content in the response.

  • Fixed
    Get object content
    GET /objects/:id/content

    Now works as expected, with format conversions via the Accept header.

  • Docs Documented the required exp claim for JWT tokens.

v0.1.0 Alpha

  • New Initial release. The start. API epoch.