Link Agents to Webhook

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

POST /webhooks/{webhook_id}/agents

Python

Python

import requests

webhook_id = "your-webhook-id"
response = requests.post(
    f"https://api.roe-ai.com/webhooks/{webhook_id}/agents/",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    json={"agent_ids": ["agent-id-1", "agent-id-2"]}
)
linked = response.json()
print(f"Linked {len(linked)} agents")

201

{
  "agent_ids": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ]
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

webhook_id · string<uuid> · required

Query Parameters

organization_id · string<uuid>

Organization ID. This is required for access control. It can be provided via query or request body depending on the endpoint.

Body

application/jsonapplication/x-www-form-urlencodedmultipart/form-data

Serializer for batch linking multiple agents to a webhook.

agent_ids · string<uuid>[] · required

List of agent IDs to link to this webhook

Minimum array length: 1

Response

201 - application/json

Serializer for batch linking multiple agents to a webhook.

agent_ids · string<uuid>[] · required

List of agent IDs to link to this webhook

Minimum array length: 1