Raster
API ReferenceGraphQL API

Changelog

Every notable change to the Raster GraphQL API, by version.

This page tracks every notable change to the Raster GraphQL API. The format follows Keep a Changelog, and the API follows Semantic Versioning.

The API is in Alpha. Until the Beta release, minor versions may include breaking changes — review this page before upgrading an integration.

0.3.0-alpha — 2026-05-22

Changed

  • Coded errors now return the data layer's explicit HTTP status on GraphQL, matching the new REST API. Previously, formatError discarded the underlying extensions.http.status and hardcoded 401 for UNAUTHORIZED and 400 for every other known code. With this change, the same error returns the same HTTP status on both transports — for example ORGANIZATION_NOT_FOUND now surfaces as 404 (was 400). The hardcoded 401/400 mapping remains only as the fallback when the thrown error carries no explicit status. Clients dispatching on extensions.code are unaffected; only clients switching on extensions.http.status for an affected code see the new (semantically correct) value.

0.2.0-alpha — 2024-08-13

Added

  • assets query: page and pageSize parameters for pagination.
  • assets query: tags parameter to filter by up to 5 tags.
  • Library type: a tags field returning detailed tag information.
  • New tags query for retrieving a library's tags.

Changed

  • Optimized database queries for better performance.
  • assets now returns both user-created and AI-generated tags.

Security

  • Hardened API key authentication checks for library access.

0.1.0-alpha — 2023-06-20

Added

  • Initial Alpha release of the Raster GraphQL API.
  • Queries for assets, libraries, and tags.
  • API key authentication.
  • Pagination for asset queries and tag filtering.

Changed

  • Adopted Apollo Server for the GraphQL endpoint.
  • Set up the Firebase Admin SDK for data access.

Security

  • Introduced API key authentication for all queries.

On this page