ChangelogChangelog

Changelog

API updates and release notes for Ctxfy.

2026-02-20Postbacks
apifeature

What changed

  • Postbacks — Optional postback_url in instructions when creating a source. Ctxfy sends an HTTP POST to your URL when the source reaches COMPLETED, FAILED, or CANCELED. See Postbacks guide.
2026-01-28Support tickets
apifeature

What changed

  • Support ticketsPOST /api/v1/support/tickets for technical and billing support requests.
  • Request body: type, reply_address, message. Enriched with user context before delivery.
2025-12-18User API keys & S3 upload
apifeature

What changed

  • User API keysPOST /api/v1/api-keys, GET /api/v1/api-keys, DELETE /api/v1/api-keys/:keyId. Keys grant access to all resources of the owner. Raw key returned only on create.
  • S3 presigned uploadPOST /api/v1/upload/s3 returns presigned URL for file uploads. Use fileKey from response when creating FILE-type sources.
2025-11-25Source actions & artifacts
apifeature

What changed

  • Source lifecyclePATCH /sources/:sourceId/toggle-pin, POST /sources/:sourceId/reprocess, POST /sources/:sourceId/cancel, POST /sources/:sourceId/refresh, POST /sources/:sourceId/restore.
  • ArtifactsGET /spaces/:spaceId/artifacts, PUT /source-artifact/:artifactId/process, PUT /source-artifact/:artifactId/promote.
2025-10-28Sources & collections
apifeature

What changed

  • CollectionsPOST /spaces/:spaceId/collections, GET /spaces/:spaceId/collections (tree). Hierarchical organization with parentId.
  • SourcesPOST /spaces/:spaceId/sources, GET /sources/:sourceId, PATCH /sources/:sourceId, DELETE /sources/:sourceId. Types: URI, FILE, CONTENT, COMPOSITION.
  • Source listingGET /spaces/:spaceId/sources, GET /collections/:collectionId/sources.
2025-09-22Initial release
apilaunch

What changed

  • SpacesPOST /api/v1/spaces, GET /api/v1/spaces, GET /api/v1/spaces/:spaceId, PUT /api/v1/spaces/:spaceId, DELETE /api/v1/spaces/:spaceId.
  • Health & metricsGET /health, GET /metrics (public, no auth).
  • Authentication — API key required for /api/v1/*. Rate limiting: Free 10 req/min, Pro 100 req/min.
Was this page helpful?

Last updated Feb 19, 2026

Built with Documentation.AI