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

# List backends



## OpenAPI

````yaml /products/link/openapi.yaml get /api/admin/backends
openapi: 3.0.0
info:
  description: >-
    Admin API for managing Link protocols and backends (Bundled and Standalone
    editions).
  title: Link API
  version: '1.0'
servers:
  - url: https://{instance}.{env}.on-hellgate.cloud
    description: Managed instance of Link
    variables:
      instance:
        default: my-instance
        description: Your unique instance slug, provided during onboarding.
      env:
        default: eu1
        description: Deployment environment (currently eu1).
security: []
tags: []
paths:
  /api/admin/backends:
    get:
      tags:
        - Backends
      summary: List backends
      operationId: backends_list
      parameters:
        - description: Pagination cursor
          in: query
          name: after
          required: false
          schema:
            type: string
        - description: Page size (default 20)
          in: query
          name: limit
          required: false
          schema:
            type: integer
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BackendListResponse'
          description: Backend list
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Unauthorized'
          description: Unauthorized
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Forbidden'
          description: Forbidden
      callbacks: {}
      security:
        - bearerAuth: []
components:
  schemas:
    BackendListResponse:
      properties:
        data:
          items:
            $ref: '#/components/schemas/BackendSummary'
          type: array
        links:
          nullable: true
          properties:
            next:
              example: /api/admin/backends?after=acme-risk&limit=20
              nullable: true
              type: string
          type: object
      required:
        - data
        - links
      title: BackendListResponse
      type: object
    Unauthorized:
      description: No valid authentication was provided.
      example:
        classifier: UNAUTHORIZED
        code: 401
        message: No valid means of authentication was provided
      properties:
        classifier:
          enum:
            - UNAUTHORIZED
          type: string
        code:
          enum:
            - 401
          type: integer
        message:
          type: string
      required:
        - classifier
        - code
        - message
      title: Unauthorized
      type: object
    Forbidden:
      description: The token lacks the scope required for this operation.
      example:
        classifier: FORBIDDEN
        code: 403
        message: Not allowed to access this resource or feature
      properties:
        classifier:
          enum:
            - FORBIDDEN
          type: string
        code:
          enum:
            - 403
          type: integer
        message:
          type: string
      required:
        - classifier
        - code
        - message
      title: Forbidden
      type: object
    BackendSummary:
      properties:
        auth_pipeline:
          $ref: '#/components/schemas/AuthPipeline'
        enabled:
          example: true
          type: boolean
        host:
          example: api.acme.example
          type: string
        id:
          example: acme-risk
          type: string
        inserted_at:
          example: '2026-05-12T09:30:00Z'
          format: date-time
          type: string
        name:
          example: Acme Risk
          type: string
        protocol:
          example: https://developer.hellgate.io/protocols/specter/v1
          type: string
      title: BackendSummary
      type: object
    AuthPipeline:
      description: >-
        How outbound requests to the provider are authenticated. An empty object
        (or omitting the pipeline) adds no authentication. A non-empty pipeline
        requires `source_type` and `credential_type`.
      example:
        source_type: inline
        credential_type: bearer
        token_prefix: token
      properties:
        credential_type:
          description: Authentication strategy
          enum:
            - hmac_sha256
            - basic
            - bearer
          type: string
        date_header:
          example: Date
          description: Header name for the date value (`hmac_sha256` only)
          type: string
        extra_headers:
          example:
            x-client-id: acme-partner
          additionalProperties:
            type: string
          description: Additional headers appended to requests
          type: object
        header_values:
          example:
            x-api-key: YOUR_PROVIDER_API_KEY
          additionalProperties:
            type: string
          description: Static header values (`hmac_sha256` only)
          type: object
        method:
          example: POST
          description: >-
            HTTP method override for the signature (`hmac_sha256` only, default
            POST)
          type: string
        signed_headers:
          example:
            - date
            - digest
          description: >-
            Headers to include in the HMAC signature. Required when
            `credential_type` is `hmac_sha256`.
          items:
            type: string
          type: array
        source_type:
          description: >-
            Where the credentials come from — inline (encrypted at rest in the
            backend record) or a Vault pointer resolved at request time.
          enum:
            - inline
            - vault
          type: string
        token_prefix:
          example: token
          description: >-
            Token prefix for bearer auth (default: "Bearer", use "token" for
            Ravelin). `bearer` only.
          type: string
      required:
        - source_type
        - credential_type
      title: AuthPipeline
      type: object
  securitySchemes:
    bearerAuth:
      bearerFormat: JWT
      scheme: bearer
      type: http

````