---
title: "Execute an agent capability"
method: POST
path: "/api/agent/task"
---

# Execute an agent capability

`POST /api/agent/task`

## Request

- Base URL: `https://goyondo.run`
- URL: `https://goyondo.run/api/agent/task`
- Auth: HTTP bearer

Preferred agent execution path. Fetch GET /api/agent/capabilities first to discover valid capability names and argument schemas.

## Request body

- AgentTaskRequest
  - `capability` 'describe_capabilities' | 'get_schema' | 'list_trips' | 'get_trip' | 'create_trip' | 'update_trip' | 'regenerate_itinerary' | 'add_activity' | 'update_activity' | 'save_itinerary' | 'list_activities' | 'get_trip_alerts' | 'delete_activity' | 'get_user_preferences' | 'list_itinerary_segments' | 'get_trip_document' | 'get_trip_expense_summary' | 'submit_group_preferences' | 'submit_group_inspiration' | 'get_group_board' | 'react_to_place' | 'update_place_candidate' | 'update_user_preferences' | 'create_group_trip' | 'list_group_trips' | 'delete_group_trip' | 'join_group_trip' | 'get_group_trip' | 'run_alignment' | 'get_alignment' | 'list_proposals' | 'approve_proposal' | 'reject_proposal' | 'get_edit_log' | 'set_user_preference' | 'get_preference_profile' | 'update_day_notes', required: Capability name from GET /api/agent/capabilities
  - `arguments` object: Arguments for the selected capability. See capability input_schema for exact fields.

## Response `200`

Capability executed

- AgentTaskResponse
  - `success` boolean
  - `result` object: Capability-specific response payload.

## Other responses

- `400`: Validation failed
- `401`: Unauthorized
- `404`: Capability not found

---

[API](https://skmtc.dev/goyondo/apis/goyondo-api.md) · [All operations](https://skmtc.dev/goyondo/apis/goyondo-api/llms.txt) · [OpenAPI document](https://skmtc.dev/goyondo/apis/goyondo-api/revisions/36faed6f335d?raw)