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

# Get a graph

> Returns the selected nodes and their neighbors within your organization. Connections are followed in both directions up to depth, while each edge keeps its original direction. Nodes and edges are deduplicated; every returned edge references nodes in the result.

Use repeated nodeIds parameters for multiple starting nodes. depth=0 returns the selected nodes and edges between them. Missing or inaccessible starting nodes return 404. See [Asset Map](/sdk/asset-map) for graph fields and querying.



## OpenAPI

````yaml /reference/openapi.yaml get /asset-map
openapi: 3.1.0
info:
  title: Antigen API
  version: v1
  description: >-
    Work with the same agents, runs, and resources your team uses in Antigen.
    Requests and responses use camelCase fields. List endpoints return arrays.
    See the [overview](/reference) for authentication, updates, and errors.
servers:
  - url: https://api.antigen.sh/v1
security:
  - ApiKeyAuth: []
tags:
  - name: Agents
    description: Retrieve, compose, and register agent configurations.
  - name: Models
    description: Models available to agents in your organization.
  - name: Targets
    description: Submit testing scope for human approval.
  - name: Runs
    description: Execute agents and control their work.
  - name: Vulnerabilities
    description: Track weaknesses, remediation, status, and assignment.
  - name: Evidence
    description: Read supporting file metadata and retrieve file contents.
  - name: Reports
    description: Read and export captured engagement results.
  - name: Human tasks
    description: Ask people for help and follow their responses.
  - name: Hooks
    description: Connect status and assignment changes to your own service.
  - name: Asset Map
    description: Read your organization’s infrastructure graph.
  - name: Integrations
    description: Inspect and disconnect provider connections.
  - name: API keys
    description: Create and revoke credentials for automation.
paths:
  /asset-map:
    get:
      tags:
        - Asset Map
      summary: Get a graph
      description: >-
        Returns the selected nodes and their neighbors within your organization.
        Connections are followed in both directions up to depth, while each edge
        keeps its original direction. Nodes and edges are deduplicated; every
        returned edge references nodes in the result.


        Use repeated nodeIds parameters for multiple starting nodes. depth=0
        returns the selected nodes and edges between them. Missing or
        inaccessible starting nodes return 404. See [Asset Map](/sdk/asset-map)
        for graph fields and querying.
      operationId: getAssetMap
      parameters:
        - name: nodeIds
          in: query
          required: true
          description: Starting node IDs. Repeat this parameter for each ID.
          schema:
            type: array
            items:
              type: string
              minLength: 1
            minItems: 1
          style: form
          explode: true
        - name: depth
          in: query
          required: false
          description: Number of connections to follow.
          schema:
            type: integer
            minimum: 0
            default: 1
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Graph'
        '400':
          $ref: '#/components/responses/Error400'
        '401':
          $ref: '#/components/responses/Error401'
        '403':
          $ref: '#/components/responses/Error403'
        '404':
          $ref: '#/components/responses/Error404'
        '429':
          $ref: '#/components/responses/Error429'
components:
  schemas:
    Graph:
      type: object
      properties:
        nodes:
          type: array
          items:
            $ref: '#/components/schemas/GraphNode'
        edges:
          type: array
          items:
            $ref: '#/components/schemas/GraphEdge'
      required:
        - nodes
        - edges
      additionalProperties: false
      example:
        nodes:
          - id: project_123
            labels:
              - SupabaseProject
            properties:
              name: production
              region: us-east-1
          - id: database_123
            labels:
              - SupabaseDatabase
              - Database
            properties:
              host: db.example.supabase.co
        edges:
          - id: edge_123
            fromId: project_123
            toId: database_123
            label: HAS_DATABASE
            properties: {}
    GraphNode:
      type: object
      properties:
        id:
          type: string
          minLength: 1
        labels:
          type: array
          items:
            type: string
        properties:
          type: object
          additionalProperties: true
          description: Integration-specific properties.
      required:
        - id
        - labels
        - properties
      additionalProperties: false
    GraphEdge:
      type: object
      properties:
        id:
          type: string
          minLength: 1
        fromId:
          type: string
          description: Source node ID.
          minLength: 1
        toId:
          type: string
          description: Destination node ID.
          minLength: 1
        label:
          type: string
          description: Relationship type.
        properties:
          type: object
          additionalProperties: true
      required:
        - id
        - fromId
        - toId
        - label
        - properties
      additionalProperties: false
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              description: Stable error code.
            message:
              type: string
              description: Description of the problem.
          required:
            - code
            - message
          additionalProperties: false
      required:
        - error
      additionalProperties: false
      example:
        error:
          code: invalid_request
          message: The target value is required.
  responses:
    Error400:
      description: Invalid request
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: invalid_request
              message: Check the request fields and values.
    Error401:
      description: Authentication required
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: unauthorized
              message: Supply a valid API key.
    Error403:
      description: Permission denied
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: forbidden
              message: The API key does not permit this operation or requested scope.
    Error404:
      description: Resource not found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: not_found
              message: The resource does not exist in this organization.
    Error429:
      description: Too many requests
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: rate_limited
              message: Retry after the interval in Retry-After.
      headers:
        Retry-After:
          description: Seconds to wait before retrying.
          schema:
            type: integer
            minimum: 1
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        API key from your organization. Supply the value directly, without a
        Bearer prefix.

````