Program graph / Tags

Query tag

Resolve a tag to the graph configuration it currently points to. This is the primary way clients discover which graph to use for a given label.

Endpoint

POST /v1/program-graph/tags.query

Request body

{
  "name": "production"
}

Response

{
  "name": "production",
  "graphId": "graph_123",
  "updatedAt": "2026-03-19T12:00:00Z"
}

Use cases

  • Have frontends or services resolve production to the active graph at runtime.
  • Support instant rollbacks by moving the tag to a previous graph without redeploying clients.