box-platform-openapi-agent/skills/ai-agents/SKILL.md

name, description

name	description
ai-agents-routes	Handle 5 OpenAPI operation(s) under /ai_agents for the ai agents route group.

ai agents API Routes

Handle 5 OpenAPI operation(s) under /ai_agents for the ai agents route group.

Use the generated operation tools to make real API calls. Do not invent API responses. If a tool reports missing setup, return the exact setup field name to the caller. For write, update, or delete operations, state the intended action before calling the tool.

Operations

get_ai_agents

• Operation ID: get_ai_agents
• Route: GET /ai_agents
• Mode: READ
• Summary: List AI agents
• Parameters:
  • mode in query
  • fields in query
  • agent_state in query
  • include_box_default in query
  • marker in query
  • limit in query

post_ai_agents

• Operation ID: post_ai_agents
• Route: POST /ai_agents
• Mode: WRITE
• Summary: Create AI agent
• Body: JSON request body accepted.

put_ai_agents_id

• Operation ID: put_ai_agents_id
• Route: PUT /ai_agents/{agent_id}
• Mode: WRITE
• Summary: Update AI agent
• Parameters:
  • agent_id in path required
• Body: JSON request body accepted.

get_ai_agents_id

• Operation ID: get_ai_agents_id
• Route: GET /ai_agents/{agent_id}
• Mode: READ
• Summary: Get AI agent by agent ID
• Parameters:
  • agent_id in path required
  • fields in query

delete_ai_agents_id

• Operation ID: delete_ai_agents_id
• Route: DELETE /ai_agents/{agent_id}
• Mode: WRITE
• Summary: Delete AI agent
• Parameters:
  • agent_id in path required