Visualization
sfp server API reference for Visualization: 8 endpoints.
/sfp/api/visualization/packages/metadataReturns metadata for a repository/branch including the commit timeline. The timeline contains commit IDs, timestamps, and ordering — suitable for building a timeline slider in the UI without loading snapshot data.
Authorization
access-token In: header
Query Parameters
Response Body
curl -X GET "https://example.com/sfp/api/visualization/packages/metadata?repositoryIdentifier=flxbl-io%2Fsf-core&branch=main&releaseConfigPath=config"/sfp/api/visualization/packages/metadataCreates or updates visualization metadata for a repository/branch. Returns the metadataId needed for batch commit uploads.
Authorization
access-token In: header
Response Body
curl -X PUT "https://example.com/sfp/api/visualization/packages/metadata"/sfp/api/visualization/packages/commitsReturns commit snapshots with pagination. Each commit contains its package snapshots (~1-5KB). Default limit is 50, max is 200. Results are ordered newest-first by commit_order.
Authorization
access-token In: header
Query Parameters
Response Body
curl -X GET "https://example.com/sfp/api/visualization/packages/commits?repositoryIdentifier=flxbl-io%2Fsf-core&branch=main"/sfp/api/visualization/packages/commits/batchUpserts a batch of commit snapshots for a given metadataId. The engine sends batches of ~100 commits at a time.
Authorization
access-token In: header
Response Body
curl -X POST "https://example.com/sfp/api/visualization/packages/commits/batch"/sfp/api/visualization/packages/commits/existingReturns the list of commit IDs already stored for a repository/branch. The engine uses this to skip commits that have already been processed.
Authorization
access-token In: header
Query Parameters
Response Body
curl -X GET "https://example.com/sfp/api/visualization/packages/commits/existing?repositoryIdentifier=flxbl-io%2Fsf-core&branch=main"/sfp/api/visualization/packages/commits/{commitId}Returns the package snapshots for a specific commit ID.
Authorization
access-token In: header
Path Parameters
Query Parameters
Response Body
curl -X GET "https://example.com/sfp/api/visualization/packages/commits/abc1234?repositoryIdentifier=flxbl-io%2Fsf-core&branch=main"/sfp/api/visualization/packages/statusCheck the current status of package visualization for a repository/branch.
Returns one of: never_ran, generating, available, or failed.
Safe to poll — does not trigger any work.
Authorization
access-token In: header
Query Parameters
Response Body
curl -X GET "https://example.com/sfp/api/visualization/packages/status?repositoryIdentifier=flxbl-io%2Fsf-core&branch=main&releaseConfigPath=config"/sfp/api/visualization/packages/refreshTriggers a new visualization data collection via Hatchet workflow. Returns a task execution ID for tracking. Returns 409 Conflict if a visualization job is already running for this repository/branch.
Authorization
access-token In: header
Query Parameters
Response Body
curl -X POST "https://example.com/sfp/api/visualization/packages/refresh?repositoryIdentifier=flxbl-io%2Fsf-core&branch=main&releaseConfigPath=config"