Changelog
Stay up to date with the latest API changes and improvements.
2025-05-20
New authentication endpoints, stable type/property keys, rate limiting, and built-in SVG icons.
Added
- New authentication endpoints:
POST /v1/auth/challengesfor creating new challengesPOST /v1/auth/api_keysfor exchanging challenge code for API key
- Support for built-in SVG as type icons
- Stable type and property keys: You can now specify these keys when creating or updating types and properties. They must be unique and follow camel_case formatting.
Changed
- Burst rate limiting (sustained 1rps, burst size 60) with option to disable via
ANYTYPE_API_DISABLE_RATE_LIMIT=1environment variable - Switched creation endpoints to return StatusCreated (201) instead of StatusOk (200)
- Improved API key generation system
- Removed ExportService dependency, now using RPC for exports
Fixed
- Request body format for
POST /spaces/:space_id/lists/:list_id/objects - Emoji input validation checks
GET /spaces/:space_id/lists/:list_id/views/:view_id/objectsnow works with built-in type queries
Breaking Changes
- Removed
formatfromPropertyLinkWithValuefor improved efficiency - Authentication endpoints (
/v1/auth/display_code,/v1/auth/token) will be deprecated in favor of new challenge-based system in the future - Added required subresource
viewsto path/spaces/:space_id/lists/:list_id/:view_id/objects [get]for retrieving objects in a list view
2025-04-22
Full CRUD operations for spaces, types, properties, and tags with enhanced metadata support.
Added
- New space management endpoint:
PATCH /spaces/:space_id
- New type management endpoints:
POST /spaces/:space_id/typesPATCH /spaces/:space_id/types/:type_idDELETE /spaces/:space_id/types/:type_id
- New property management endpoints:
GET /spaces/:space_id/propertiesGET /spaces/:space_id/properties/:property_idPOST /spaces/:space_id/propertiesPATCH /spaces/:space_id/properties/:property_idDELETE /spaces/:space_id/properties/:property_id
- New tag management endpoints:
GET /spaces/:space_id/properties/:property_id/tagsGET /spaces/:space_id/properties/:property_id/tags/:tag_idPOST /spaces/:space_id/properties/:property_id/tagsPATCH /spaces/:space_id/properties/:property_id/tags/:tag_idDELETE /spaces/:space_id/properties/:property_id/tags/:tag_id
- Added property
idalongsidekeyin responses - Return linked
properties(featured and from sidebar) andplural_namefor types
Changed
- Renamed
recommended_layouttolayoutfor types - Moved
descriptionandsourceto[]propertiesinCreateObjectRequest - Renamed layout
todotoactionfor consistency - Removed
ot-prefix for type keys - Renamed
propertytoproperty_keyin sort options in search
Breaking Changes
- Deprecated separate markdown export, unified with
getObject - Deprecated
blocksingetObjectin favor ofmarkdownexported body
2025-03-17
Collections and member management, OpenAPI 3.1 upgrade, and enhanced object properties.
Added
- New space endpoint:
GET /spaces/:space_id
- New space member endpoint:
GET /spaces/:space_id/members/:member_idPATCH /spaces/:space_id/members/:member_id
- New list (collection/query) endpoints:
GET /spaces/:space_id/lists/:list_id/viewsGET /spaces/:space_id/lists/:list_id/views/view_id/objectsPOST /spaces/:space_id/lists/:list_id/objectsDELETE /spaces/:space_id/lists/:list_id/objects
- Added
Anytype-Versionto response headers - Added
nameas sort property option for search endpoints - Added
descriptionfield for spaces - Included custom
properties(formerly: relations) in object response details
Changed
- Upgraded Swagger specification to OpenAPI 3.1
- Implemented
last_modifiedas a fallback sort criterion for thelast_openedsort - Updated status codes for deleted resources:
GET /spaces/:space_id/objects/:object_idnow returns 410 for deleted objectsGET /spaces/:space_id/types/:type_idnow returns 410 for deleted typesGET /spaces/:space_id/types/:type_id/templates/:template_idnow returns 410 for deleted templates
- Archived objects, types and templates now have
archived: trueflag
Fixed
- Corrected error mapping originating from middleware functions
Breaking Changes
- Renamed
detailstopropertieswith explicitformatfield and standardized naming conventions - Standardized icon structure with clear format differentiation (
emoji,file, oricon) - Renamed
timestamptopropertyin sort for search endpoints - Renamed
unique_keytokeyfor types - Renamed
object_type_unique_keytotype_keyfor object creation - Changed markdown export endpoint to
GET /spaces/:space_id/objects/:object_id/:format
2025-02-12
Basic object and space operations to enable first version of Raycast extension.
Added
- Basic object and space operations to enable first version of Raycast extension