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

# List Webhook Agents

> List agents linked to a webhook, or link new agents.

GET: List all agents linked to this webhook
POST: Link one or more agents to this webhook



## OpenAPI

````yaml GET /webhooks/{webhook_id}/agents/
openapi: 3.1.0
info:
  title: Roe AI API
  version: 1.0.0
  description: Complete API documentation for Roe AI platform
servers:
  - url: https://api.roe-ai.com
    description: Production API
security: []
paths:
  /webhooks/{webhook_id}/agents/:
    get:
      tags:
        - webhooks
      description: |-
        List agents linked to a webhook, or link new agents.

        GET: List all agents linked to this webhook
        POST: Link one or more agents to this webhook
      operationId: webhooks_agents_list
      parameters:
        - in: path
          name: webhook_id
          schema:
            type: string
            format: uuid
          required: true
        - name: organization_id
          in: query
          required: false
          schema:
            type: string
            format: uuid
          description: >-
            Organization ID. This is required for access control. It can be
            provided via query or request body depending on the endpoint.
      responses:
        '200':
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/WebhookAgent'
          description: ''
      security:
        - jwtAuth: []
      x-codeSamples:
        - lang: Python
          source: |
            import requests

            webhook_id = "your-webhook-id"
            response = requests.get(
                f"https://api.roe-ai.com/webhooks/{webhook_id}/agents/",
                headers={"Authorization": "Bearer YOUR_API_KEY"}
            )
            agents = response.json()
            for agent in agents:
                print(f"Agent: {agent['agent_name']}")
        - lang: TypeScript
          source: |
            const webhookId = "your-webhook-id";
            const response = await fetch(
              `https://api.roe-ai.com/webhooks/${webhookId}/agents/`,
              { headers: { "Authorization": "Bearer YOUR_API_KEY" } }
            );
            const agents = await response.json();
            console.log(agents);
        - lang: cURL
          source: >
            curl -X GET
            "https://api.roe-ai.com/webhooks/YOUR_WEBHOOK_ID/agents/" \
              -H "Authorization: Bearer YOUR_API_KEY"
components:
  schemas:
    WebhookAgent:
      type: object
      description: Serializer for listing agents linked to a webhook.
      properties:
        id:
          type: string
          format: uuid
          readOnly: true
        agent_id:
          type: string
          format: uuid
          readOnly: true
        agent_name:
          type:
            - string
            - 'null'
          readOnly: true
      required:
        - agent_id
        - agent_name
        - id
  securitySchemes:
    jwtAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````