Mint a short-lived embed token for the 3D index visualization
Authenticated with X-API-Key. Returns a signed token and optional embed_url for the Cloudflare Pages visualization app. Omit both entity_ids and cluster_ids to visualize the full workspace catalog (clusters from Convex sdkCatalogEntities.tasteAffinities, capped server-side). Optional cluster_ids narrows to those clusters; optional entity_ids filters catalog entities. Graph JSON is loaded via Convex (not Turbopuffer layout). Requires GALYA_VISUALIZE_TOKEN_SECRET; optional GALYA_VISUALIZE_PAGES_URL for embed_url. Graph fetch uses CONVEX_URL + GALYA_WORKER_AUTH_SECRET.
Authorization
ApiKeyAuth In: header
Query Parameters
Optional comma-separated catalog entity ids (subset filter).
Optional comma-separated cluster ids to scope the view.
Token lifetime in seconds (60–3600, default 900).
60 <= value <= 3600Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/visualize"{
"token": "string",
"embed_url": "string",
"expires_at": "2019-08-24T14:15:22Z",
"ttl_sec": 0,
"entity_ids": [
"string"
],
"cluster_ids": [
"string"
]
}{
"error": "string",
"code": "string"
}{
"error": "string",
"code": "string"
}{
"error": "string",
"code": "string"
}