Skip to main content
GET
/
api
/
v1
/
workspaces
/
{workspace_id}
/
stats
Get Workspace Stats
curl --request GET \
  --url https://api.example.com/api/v1/workspaces/{workspace_id}/stats \
  --header 'X-API-Key: <api-key>'
{
  "artifact_type_breakdown": {},
  "dependency_type_breakdown": {},
  "health": {
    "consumers_lagging": 123,
    "consumers_on_latest": 123,
    "unresolved_declarations": 123
  },
  "last_scan": {
    "completed_at": "2023-11-07T05:31:56Z",
    "errors": 123,
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "repos_scanned": 123,
    "status": "<string>"
  },
  "orphan_artifact_count": 123,
  "total_artifact_rows": 123,
  "total_artifacts": 123,
  "total_dependencies": 123,
  "total_repositories": 123
}

Documentation Index

Fetch the complete documentation index at: https://docs.riftmap.dev/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

X-API-Key
string
header
required

Headers

X-Workspace-Id
string | null

Path Parameters

workspace_id
string<uuid>
required

Cookies

riftmap_access
string | null

Response

Successful Response

Per-connected-org stats payload (scoped to one connected org).

Artifact-count semantics:

  • total_artifacts / artifact_type_breakdown count consumed artifacts only and apply canonical-name dedup (e.g. ghcr.io/foo/bar and foo/bar collapse to one logical artifact). Invariant: sum(artifact_type_breakdown.values()) == total_artifacts.
  • total_artifact_rows / orphan_artifact_count are raw row counts that match what GET /connected-orgs/{id}/artifacts returns — no dedup, no consumed-only filter. total_artifact_rows - orphan_artifact_count is the raw count of artifacts with at least one consumer.
artifact_type_breakdown
Artifact Type Breakdown · object
required
dependency_type_breakdown
Dependency Type Breakdown · object
required
health
HealthSummary · object
required

Aggregate health indicators.

last_scan
LastScanSummary · object
required

Summary of the most recent scan.

orphan_artifact_count
integer
required
total_artifact_rows
integer
required
total_artifacts
integer
required
total_dependencies
integer
required
total_repositories
integer
required