Changelog

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

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 + Duration 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/relatedGET /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.