Skip to main content

Changelog

A chronological log of changes to the Anytype API. Each entry is the anytype-heart release that shipped it and notes the API version (the Anytype-Version value) the change applies to. A new API version is minted only for breaking changes.

Chat API

Shipped June 1, 2026 in anytype-heart v0.50.7 · applies to API version 2025-11-08 (no version change).

Backward-compatible additions exposing real-time chat on spaces and objects.

Added​

  • POST /v1/spaces/:space_id/chats to create a chat
  • GET /v1/spaces/:space_id/chats to list chats in a space
  • POST /v1/spaces/:space_id/chats/:chat_id/messages to add a message
  • GET /v1/spaces/:space_id/chats/:chat_id/messages to list messages
  • GET /v1/spaces/:space_id/chats/:chat_id/messages/:message_id to get a single message
  • PUT /v1/spaces/:space_id/chats/:chat_id/messages/:message_id to edit a message
  • DELETE /v1/spaces/:space_id/chats/:chat_id/messages/:message_id to delete a message
  • GET /v1/spaces/:space_id/chats/:chat_id/messages/stream for SSE-based real-time message streaming
  • POST /v1/spaces/:space_id/chats/:chat_id/messages/search to search messages
  • POST /v1/spaces/:space_id/chats/:chat_id/messages/:message_id/reactions to toggle a reaction
  • GET /v1/spaces/:space_id/chats/:chat_id/messages/reactions to read reactions
  • POST /v1/spaces/:space_id/chats/:chat_id/messages/read to mark messages as read
  • POST /v1/spaces/:space_id/chats/:chat_id/messages/read_all to mark all messages as read

File management

Shipped May 13, 2026 in anytype-heart v0.50.5 · applies to API version 2025-11-08 (no version change).

Backward-compatible additions. Availability depends on the running anytype-heart build — a client can confirm support by checking the files paths in the spec served at GET /docs/openapi.json by the local instance.

Added​

  • POST /v1/spaces/:space_id/files to upload a file
  • GET /v1/spaces/:space_id/files/:file_id to download a file
  • DELETE /v1/spaces/:space_id/files/:file_id to delete a file

API version 2025-11-08

Shipped December 11, 2025 in anytype-heart v0.46.3.

Markdown body patching, object type updates, inline tag creation, and property-based filtering.

Added​

  • Markdown body patching: Update an object's markdown body via UpdateObjectRequest (#5)
  • Update object type: Patch an object's type_key to change its type
  • Inline tag creation: Add tags directly in CreatePropertyRequest for select and multi_select properties
  • Property-based filtering: Filter listing and search endpoints using query parameters

Changed​

  • Improved type, property, and tag map lookup performance via subscription-based caching
  • No-op changes to type or property keys are now ignored, preventing spurious errors when patching unchanged keys

Fixed​

  • Clarified error messages for reserved system properties
  • Property key now correctly populated when creating a type with properties
  • Corrected icon name enum values in the OpenAPI spec
  • Clarified nullable icons and types in the OpenAPI schema
  • API error messages now show the actual invalid key name instead of an empty property key (#2633)
  • Search no longer returns types for deleted type keys (#7)

Deprecated​

  • Authentication endpoints /v1/auth/display_code and /v1/auth/token in favor of the challenge-based system (/v1/auth/challenges and /v1/auth/api_keys) introduced in 2025-05-20

API version 2025-05-20

Shipped June 17, 2025 in anytype-heart v0.41.0.

New authentication endpoints, stable type/property keys, rate limiting, and built-in SVG icons. Contains breaking changes — review them before upgrading a pinned client.

Added​

  • New authentication endpoints:
    • POST /v1/auth/challenges to create a challenge
    • POST /v1/auth/api_keys to exchange a challenge code for an API key
  • Support for built-in SVG type icons
  • Stable type and property keys: specify these keys when creating or updating types and properties. Keys must be unique and use camel_case.

Changed​

  • Added burst rate limiting (sustained 1 rps, burst size 60), disable via the ANYTYPE_API_DISABLE_RATE_LIMIT=1 environment variable
  • Creation endpoints now return 201 Created instead of 200 OK
  • Improved the API key generation system
  • Removed the ExportService dependency; exports now use RPC

Fixed​

  • Corrected request body format for POST /spaces/:space_id/lists/:list_id/objects
  • Fixed emoji input validation
  • GET /spaces/:space_id/lists/:list_id/views/:view_id/objects now works with built-in type queries

Breaking changes​

  • Removed format from PropertyLinkWithValue for improved efficiency
  • Authentication endpoints (/v1/auth/display_code, /v1/auth/token) flagged for deprecation in favor of the new challenge-based system
  • Added required views subresource to GET /spaces/:space_id/lists/:list_id/:view_id/objects for retrieving objects in a list view

API version 2025-04-22

Shipped May 6, 2025 in anytype-heart v0.40.20. First stable release carrying the Anytype-Version header.

Full CRUD for spaces, types, properties, and tags, plus collections and member management, OpenAPI 3.1, and enhanced object properties. Also includes everything originally documented under API version 2025-03-17, which never shipped as the served version (its constant was superseded by 2025-04-22 before this release). Contains breaking changes.

Added​

  • Space management:
    • GET /spaces/:space_id
    • PATCH /spaces/:space_id
  • Space member management:
    • GET /spaces/:space_id/members/:member_id
    • PATCH /spaces/:space_id/members/:member_id
  • Type management:
    • POST /spaces/:space_id/types
    • PATCH /spaces/:space_id/types/:type_id
    • DELETE /spaces/:space_id/types/:type_id
  • Property management:
    • GET /spaces/:space_id/properties
    • GET /spaces/:space_id/properties/:property_id
    • POST /spaces/:space_id/properties
    • PATCH /spaces/:space_id/properties/:property_id
    • DELETE /spaces/:space_id/properties/:property_id
  • Tag management:
    • GET /spaces/:space_id/properties/:property_id/tags
    • GET /spaces/:space_id/properties/:property_id/tags/:tag_id
    • POST /spaces/:space_id/properties/:property_id/tags
    • PATCH /spaces/:space_id/properties/:property_id/tags/:tag_id
    • DELETE /spaces/:space_id/properties/:property_id/tags/:tag_id
  • List (collection/query) endpoints:
    • GET /spaces/:space_id/lists/:list_id/views
    • GET /spaces/:space_id/lists/:list_id/views/:view_id/objects
    • POST /spaces/:space_id/lists/:list_id/objects
    • DELETE /spaces/:space_id/lists/:list_id/objects
  • Property id alongside key in responses
  • Linked properties (featured and from sidebar) and plural_name returned for types
  • Anytype-Version response header
  • name as a sort property option for search endpoints
  • description field for spaces
  • Custom properties (formerly relations) in object response details

Changed​

  • Renamed recommended_layout to layout for types
  • Moved description and source to []properties in CreateObjectRequest
  • Renamed layout todo to action for consistency
  • Removed ot- prefix for type keys
  • Renamed property to property_key in sort options in search
  • Upgraded the spec to OpenAPI 3.1
  • Added last_modified as a fallback sort criterion for the last_opened sort
  • Updated status codes for deleted resources:
    • GET /spaces/:space_id/objects/:object_id now returns 410 for deleted objects
    • GET /spaces/:space_id/types/:type_id now returns 410 for deleted types
    • GET /spaces/:space_id/types/:type_id/templates/:template_id now returns 410 for deleted templates
  • Archived objects, types, and templates now have an archived: true flag

Fixed​

  • Corrected error mapping originating from middleware functions

Breaking changes​

  • Deprecated the separate markdown export; unified with getObject
  • Deprecated blocks in getObject in favor of the markdown exported body
  • Renamed details to properties with explicit format field and standardized naming conventions
  • Standardized icon structure with clear format differentiation (emoji, file, or icon)
  • Renamed timestamp to property in sort for search endpoints
  • Renamed unique_key to key for types
  • Renamed object_type_unique_key to type_key for object creation
  • Changed markdown export endpoint to GET /spaces/:space_id/objects/:object_id/:format

API version 2025-02-12

Initial release — February 12, 2025. Predates the Anytype-Version header mechanism.

Added​

  • Basic object and space operations to enable the first version of the Raycast extension