v8

latestOpenAPI 3.0.0Apache 2.0raw.githubusercontent.com2025-10-165266542.4 MB

DigitalOcean-public.v2-new_GradientAI Platform

Update Agent Route for an Agent

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

put/v2/gen-ai/agents/{parent_agent_uuid}/child_agents/{child_agent_uuid}

Path parameters

parent_agent_uuidstring required

A unique identifier for the parent agent.

child_agent_uuidstring required

Routed agent id

Request body

child_agent_uuidstring

Routed agent id

if_casestring

Describes the case in which the child agent should be used

parent_agent_uuidstring

A unique identifier for the parent agent.

route_namestring

Route name

uuidstring

Unique id of linkage

Example request

{
  "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\"",
  "uuid": "\"12345678-1234-1234-1234-123456789012\""
}

Response

A successful response.

child_agent_uuidstring

Routed agent id

parent_agent_uuidstring

A unique identifier for the parent agent.

rollbackboolean

uuidstring

Unique id of linkage

Example response

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