Changelog
API updates and release notes for Ctxfy.
2026-02-20Postbacks
apifeature
What changed
- Postbacks — Optional
postback_urlininstructionswhen 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/ticketsfor 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/s3returns presigned URL for file uploads. UsefileKeyfrom 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 withparentId. - 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?
Last updated Feb 19, 2026
Built with Documentation.AI