Give Feedback

pydo.genai.attach_agent()

Generated on 8 May 2026 from pydo version v0.34.0

Copy page as Markdown View page as Markdown

Usage

client.genai.attach_agent(
    parent_agent_uuid="\"123e4567-e89b-12d3-a456-426614174000\"",
    child_agent_uuid="\"123e4567-e89b-12d3-a456-426614174000\"",
    body={
        "child_agent_uuid": "\"12345678-1234-1234-1234-123456789012\"",
        "if_case": "\"use this to get weather information\"",
        "parent_agent_uuid": "\"12345678-1234-1234-1234-123456789012\"",
        ...,
    },
)

Returns JSONRaises HttpResponseError

Description

To add an agent route to an agent, send a POST request to /v2/gen-ai/agents/{parent_agent_uuid}/child_agents/{child_agent_uuid}.

Parameters

parent_agent_uuid string required

A unique identifier for the parent agent.

child_agent_uuid string required

Routed agent id

child_agent_uuid string optional

Example: "12345678-1234-1234-1234-123456789012"

Routed agent id

if_case string optional

Example: "use this to get weather information"

parent_agent_uuid string optional

Example: "12345678-1234-1234-1234-123456789012"

A unique identifier for the parent agent.

route_name string optional

Example: "weather_route"

Name of route

Request Sample

Show Request Sample

import os
from pydo import Client

client = Client(token=os.environ.get("DIGITALOCEAN_TOKEN"))

req = {
  "child_agent_uuid": "\"12345678-1234-1234-1234-123456789012\"",
  "if_case": "\"use this to get weather information\"",
  "parent_agent_uuid": "\"12345678-1234-1234-1234-123456789012\"",
  "route_name": "\"weather_route\""
}

resp = client.genai.attach_agent(parent_agent_uuid="\"123e4567-e89b-12d3-a456-426614174000\"", child_agent_uuid="\"123e4567-e89b-12d3-a456-426614174000\"", body=req)

Response Example

Show Response Example

{
  "child_agent_uuid": "123e4567-e89b-12d3-a456-426614174000",
  "parent_agent_uuid": "123e4567-e89b-12d3-a456-426614174000"
}

More Information

See /v2/gen-ai/agents/{parent_agent_uuid}/child_agents/{child_agent_uuid} in the API reference for additional detail on responses, headers, parameters, and more.