Symbols API Reference

Operations

GET /api/v1/buildinfo

API alias for /buildinfo.json (same payload).

Responses:

GET /api/v1/symbols/marketplace

List symbol pack catalog entries

Returns a paginated list of symbol pack catalog entries, optionally filtered by source ID and a free-text search term. Results include pack metadata and are bounded by the configured limit and offset. Requires authentication.

Parameters:

Responses:

GET /api/v1/symbols/marketplace/installed

List installed symbol packs

Returns all symbol packs currently installed for the requesting tenant. Returns 400 if the X-StellaOps-TenantId header is missing. Requires authentication.

Responses:

GET /api/v1/symbols/marketplace/search

Search catalog by PURL or platform

Searches the symbol pack marketplace catalog by a free-text query (q) or platform string. Falls back to platform if q is empty. Returns matching catalog entries up to the specified limit. Requires authentication.

Parameters:

Responses:

POST /api/v1/symbols/marketplace/sync

Trigger marketplace sync from configured sources

Enqueues a marketplace sync job to refresh the symbol pack catalog from all configured sources for the requesting tenant. Returns 202 Accepted with the queued status. Returns 400 if the X-StellaOps-TenantId header is missing. Requires authentication.

Responses:

GET /api/v1/symbols/marketplace/{entryId}

Get catalog entry detail

Returns the full catalog entry record for a specific marketplace entry ID including pack metadata, publisher, version, and install eligibility. Returns 404 if the entry is not found. Requires authentication.

Parameters:

Responses:

POST /api/v1/symbols/marketplace/{entryId}/install

Install a symbol pack from the marketplace

Installs a symbol pack from the marketplace catalog for the requesting tenant, recording the installation against the specified catalog entry ID. Returns 200 with the installation status. Returns 400 if the X-StellaOps-TenantId header is missing. Requires authentication.

Parameters:

Responses:

POST /api/v1/symbols/marketplace/{entryId}/uninstall

Uninstall a symbol pack

Removes the installation of a symbol pack for the requesting tenant by catalog entry ID. Returns 200 with the uninstall status. Returns 400 if the X-StellaOps-TenantId header is missing. Requires authentication.

Parameters:

Responses:

GET /api/v1/symbols/sources

List symbol sources with freshness projections

Returns all configured symbol pack sources with their freshness projections, sync state, and trust metadata. Optionally includes disabled sources when includeDisabled is true. Requires authentication.

Parameters:

Responses:

POST /api/v1/symbols/sources

Create a new symbol source

Creates a new symbol pack source with the provided configuration. Assigns a new ID if not supplied. Returns 201 Created with the created source record. Requires authentication.

Responses:

GET /api/v1/symbols/sources/summary

Get symbol source summary cards

Returns aggregated health summary cards for all enabled symbol sources including counts of healthy, warning, stale, and unavailable sources and the average trust score across the fleet. Requires authentication.

Responses:

GET /api/v1/symbols/sources/{id}

Get symbol source detail with trust score

Returns the full symbol source record by ID including its sync state, freshness projection, and computed trust score breakdown. Returns 404 if the source is not found. Requires authentication.

Parameters:

Responses:

PUT /api/v1/symbols/sources/{id}

Update a symbol source

Replaces the configuration of an existing symbol source by ID, updating its metadata, freshness SLA, and enabled state. Returns 200 with the updated source record. Requires authentication.

Parameters:

Responses:

DELETE /api/v1/symbols/sources/{id}

Disable (soft-delete) a symbol source

Soft-deletes (disables) a symbol source by ID, preventing it from appearing in default listings without permanently removing its history. Returns 204 No Content on success. Requires authentication.

Parameters:

Responses:

GET /api/v1/symbols/sources/{id}/freshness

Get symbol source freshness detail

Returns freshness detail for a specific symbol source including status, age in seconds, SLA threshold, last sync time, last successful sync, last error, and cumulative sync and error counts. Returns 404 if the source is not found. Requires authentication.

Parameters:

Responses:

GET /buildinfo.json

Image build provenance (module, gitSha, gitCommitTime, imageBuiltAt, branch) for drift detection.

Responses:

GET /health

Health check endpoint

Responses:

GET /v1/symbols/by-debug-id/{debugId}

Get manifests by debug ID

Parameters:

Responses:

GET /v1/symbols/manifests

Query symbol manifests

Parameters:

Responses:

POST /v1/symbols/manifests

Upload a symbol manifest

Responses:

GET /v1/symbols/manifests/{manifestId}

Get symbol manifest by ID

Parameters:

Responses:

POST /v1/symbols/resolve

Resolve symbol addresses

Responses: