Fix incorrect agent API request example payload structure

[IshaMeera]

Relevant issues
N/A

Linear ticket
N/A

Pre-Submission checklist
My PR's scope is as isolated as possible, it only solves 1 specific problem
Screenshots / Proof of Fix - Attached SS with and without agent wrapper with its respective response.
Before
The documented Swagger/OpenAPI examples for agent endpoints wrapped request payloads inside:

{
"agent": {
...
}
}
Sending the documented payload resulted in:

422 validation error
loc: ["body", "agent_name"]
After
Updated examples to use root-level request bodies:

{
"agent_name": "...",
"agent_card_params": { ... },
"litellm_params": { ... }
}
Verified locally:

Nested payload → 422 validation error
Root-level payload → 200 success
Verified updated examples through /openapi.json
Verified formatting with Black
Type
📖 Documentation
🐛 Bug Fix

Changes
Fix incorrect Agent API request examples in OpenAPI/Swagger documentation.

Root cause:
Agent endpoints accept request models directly (request: AgentConfig, request: PatchAgentRequest) and therefore expect root-level request fields rather than an outer agent object.

Updated examples for:

POST /v1/agents
PUT /v1/agents/{agent_id}
PATCH /v1/agents/{agent_id}
Also updated related example URLs for consistency:

GET /v1/agents/{agent_id}
DELETE /v1/agents/{agent_id}
Changes made:

• Removed outer "agent" wrapper from example payloads
• Updated /agents → /v1/agents
• Corrected PATCH curl example to use the appropriate HTTP method
• Cleaned example indentation

[greptile-apps]

Greptile Summary

This PR fixes the OpenAPI/Swagger example curl commands embedded in the agent endpoint docstrings. The examples previously wrapped request bodies in an "agent" object that the API never expected, causing 422 validation errors when users copied them verbatim.

• Removed the outer "agent" wrapper from the POST, PUT, and PATCH example payloads so they match the AgentConfig and PatchAgentRequest flat models that FastAPI deserializes directly.
• Updated example URLs from /agents to /v1/agents to match the actual registered router paths, and corrected the PATCH endpoint's example from curl -X PUT to curl -X PATCH.

Confidence Score: 5/5

Safe to merge — only docstring content is changed, with no functional code altered.

All changes are confined to example curl commands inside Python docstrings. The corrected payloads now match the actual FastAPI route signatures (request: AgentConfig, request: PatchAgentRequest), and the URLs and HTTP methods align with the router decorators in the same file. No runtime logic is touched.

No files require special attention.

Important Files Changed

Filename	Overview
litellm/proxy/agent_endpoints/endpoints.py	Docstring-only fix: removes incorrect "agent" wrapper from example request payloads, updates URLs from /agents to /v1/agents, and corrects the PATCH example's HTTP method from PUT to PATCH.

_{Reviews (1): Last reviewed commit: "Fix incorrect agent API request example ..." | Re-trigger Greptile}

[codecov]

Codecov Report

❌ Patch coverage is 75.00000% with 4 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
litellm/proxy/agent_endpoints/endpoints.py	75.00%	4 Missing ⚠️

📢 Thoughts on this report? Let us know!

[Sameerlite]

LGTM, thanks!