> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ariacompute.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Router Topology and Dependency Graph API

> Retrieve the live dependency graph mapping entrypoints to recipes and providers in the Aria Compute ROUTER.

The Topology endpoint exposes the current routing dependency graph. Call it to inspect how entrypoints resolve to recipes, which in turn target providers and models. This helps you debug routing behavior and understand configuration impact.

The response is read-only and available to any authenticated caller.

## Endpoint

```http theme={null}
GET /v1/router/topology
```

## Authentication

Authenticate with a session cookie or pass `Authorization: Bearer <api-key>`.

## Response

<ResponseField name="graph" type="object">
  Root object containing the dependency graph.

  <Expandable title="properties">
    <ResponseField name="entrypoints" type="array">
      List of entrypoint nodes in the dependency graph.

      <Expandable title="items">
        <ResponseField name="id" type="string">
          Unique entrypoint identifier.
        </ResponseField>

        <ResponseField name="recipe" type="string">
          The recipe this entrypoint routes to.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="recipes" type="array">
      List of recipe nodes with their target providers.

      <Expandable title="items">
        <ResponseField name="id" type="string">
          Unique recipe identifier.
        </ResponseField>

        <ResponseField name="type" type="string">
          Recipe kind. Values: `semantic`, `agent`.
        </ResponseField>

        <ResponseField name="providers" type="array">
          Providers selected by this recipe.

          <Expandable title="strings" />
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="providers" type="array">
      List of provider nodes.

      <Expandable title="items">
        <ResponseField name="id" type="string">
          Unique provider identifier.
        </ResponseField>

        <ResponseField name="models" type="array">
          Model names served by this provider.

          <Expandable title="strings" />
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "graph": {
      "entrypoints": [
        { "id": "default-chat", "recipe": "semantic-router" }
      ],
      "recipes": [
        {
          "id": "semantic-router",
          "type": "semantic",
          "providers": ["openai", "anthropic"]
        }
      ],
      "providers": [
        {
          "id": "openai",
          "models": ["gpt-4o", "gpt-4o-mini"]
        },
        {
          "id": "anthropic",
          "models": ["claude-3-5-sonnet-20241022"]
        }
      ]
    }
  }
  ```
</ResponseExample>


## Related topics

- [HTTP status codes and error responses](/resources/errors.md)
- [Authenticate with Aria Compute ROUTER](/api-reference/router/authentication.md)
- [Router Health and Overview API](/api-reference/router/management/overview.md)
- [Router Config Validation API](/api-reference/router/management/validate.md)
- [Router Cost Aggregation API](/api-reference/router/cost.md)