Look after your organization's Subgraphs from the terminal: see which Managed Subgraphs are synced, give applications a stable query URL, and inspect any published Subgraph's schema. To deploy a Subgraph and release new versions, see Deploy your own Subgraph and Develop and release a Subgraph.
Manage Managed Subgraphs
graphops subgraphs listlists your Managed Subgraphs with their status, such asSyncing (1200 blocks behind)orSuspended (credits exhausted), and their promotion state, such asReady to promote. Those being deleted appear only with--all.graphops subgraphs status <name>shows the Current and Next versions, andgraphops subgraphs history <name>every version, newest first.graphops subgraphs rename <name> <new-name>renames a Managed Subgraph.graphops subgraphs target-type <name> --subgraph-id <id>makes it follow a Graph Network Subgraph ID, so new versions are staged and promoted for you.--current-cidstops following and keeps the current Deployment CID.graphops subgraphs delete <name> --confirm <name>deletes it: indexing stops and so does its billing. Cancel a staged upgrade withgraphops subgraphs unstageand remove its Endpoint Aliases first.
Manage Endpoint Aliases
An Endpoint Alias keeps one query URL for your application while the version behind it changes. Endpoint Aliases explains what each target type serves and when it moves.
graphops subgraphs endpoint-aliases create <alias>creates an Endpoint Alias for a Deployment CID (--cid), a Managed Subgraph (--managed-subgraph) or a Graph Network Subgraph ID (--subgraph-id).--behaviorsets what it follows:currentornextfor a Managed Subgraph,latest-availableorlatestfor a Graph Network Subgraph ID.graphops subgraphs endpoint-aliases create,showandlistprint each alias's query URL, the address your application queries, and name a Managed Subgraph target by its name.graphops subgraphs endpoint-aliases retargetpoints an alias at another target, andgraphops subgraphs endpoint-aliases updatechanges its behavior. Applications using the alias's URL switch at once.retargetprints the old and new target. Both refuse to point an alias at a Managed Subgraph version that is not yet synced and healthy, including a Next version for thenextbehavior, unless you pass--force.graphops subgraphs endpoint-aliases delete <alias> --confirm <alias>deletes it, and its URL stops working.
Explore published Subgraphs
graphops subgraphs browsepages through published Subgraphs;--searchand--networknarrow them. Each row shows the Graph Network Subgraph ID and current Deployment CID.- For a Graph Network Subgraph ID (
--subgraph-id), a Deployment CID (--cid) or both,graphops subgraphs exploresummarizes the manifest,schemaprints the GraphQL schema,entitieslists entities and their fields,manifestprints the manifest, andmetadatashows the network and start block.
Developer workflow shows how to go from a schema to a query with your stored key. Identifier types explains which identifier an application should query.
Next steps
Last updated
Manage keys and service accounts
Create, change, rotate and revoke API keys and service accounts from the GraphOps CLI, and replace a key without downtime.
Check usage, credits and billing
Read your organization's credit consumption, balance, ledger and plan from the GraphOps CLI, by day, hour, API key or resource.