Remove subgraph

Use this endpoint to remove a deployed Program graph subgraph from YDYL. Removing a subgraph does not delete underlying data sources; it only tears down the deployment and stops serving queries for that subgraph.

Endpoint

POST /v1/program-graph/subgraphs/remove

Request body

{
  "name": "national-transport-mainnet",
  "version": "2026.03.19-1"
}

• name – logical name of the subgraph to remove.
• version – specific version identifier to remove. Required to avoid accidentally removing the wrong deployment.

Response

{
  "code": 200,
  "msg": "subgraph removed",
  "data": {
    "name": "national-transport-mainnet",
    "version": "2026.03.19-1"
  }
}

Typical flow

• List active deployments for a program.
• Confirm the subgraph name and version you want to retire.
• Call /v1/program-graph/subgraphs/remove and monitor status from the YDYL status page.