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 tickets — POST /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 keys — POST /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 upload — POST /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 lifecycle — PATCH /sources/:sourceId/toggle-pin, POST /sources/:sourceId/reprocess, POST /sources/:sourceId/cancel, POST /sources/:sourceId/refresh, POST /sources/:sourceId/restore.
  • Artifacts — GET /spaces/:spaceId/artifacts, PUT /source-artifact/:artifactId/process, PUT /source-artifact/:artifactId/promote.
2025-10-28Sources & collections
apifeature

What changed

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

What changed

  • Spaces — POST /api/v1/spaces, GET /api/v1/spaces, GET /api/v1/spaces/:spaceId, PUT /api/v1/spaces/:spaceId, DELETE /api/v1/spaces/:spaceId.
  • Health & metrics — GET /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?