Knowledge Graph API
Last updated: June 10, 2026
The Knowledge Graph API exposes data from Span for operational or agentic needs. The API design is focused around metadata discovery and node traversal.
Authentication & Authorization
There are two ways to authenticate:
Service Account — Add the account to a permission group with the required access levels via Settings > Permissions.
Personal Access Token — Generate a token under Settings > Personal > Access Token to authenticate with your own permissions.
The API enforces authorization according to the privileges set within the Span platform.
Discovery
Start here. The metadata endpoints — GET /next/metadata/assets and GET /next/metadata/metrics — describe every queryable asset type, its fields, relations, and available metrics. Metric definitions are subject to the caller's permissions.