# Goyondo API API

**Canonical:** https://apis.io/apis/goyondo-run/goyondo-api-api/  
**Provider:** Goyondo — https://apis.io/providers/goyondo-run/  
**Base URL:** https://goyondo.run  
**Documentation:** https://goyondo.run/openapi.json

Goyondo API API is one of 2 APIs that [Goyondo](https://apis.io/providers/goyondo-run/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

API for trip planning, itineraries, and bookings. Use with Bearer token (Clerk session or API key gyd_*).

## Operations (39)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/agent-manifest` | Agent manifest |
| GET | `/api/agent/capabilities` | List executable agent capabilities |
| POST | `/api/agent-auth/device` | Initiate device authorization |
| POST | `/api/agent-auth/token` | Poll for approved device token |
| POST | `/api/agent/task` | Execute an agent capability |
| GET | `/api/openapi.json` | OpenAPI spec |
| GET | `/api/trips` | List trips |
| POST | `/api/trips` | Create trip |
| GET | `/api/trips/{id}` | Get trip and itinerary |
| PUT | `/api/trips/{id}` | Update trip |
| DELETE | `/api/trips/{id}` | Delete trip |
| GET | `/api/trips/{id}/fixed-plans` | List fixed plans and any overlaps between them |
| POST | `/api/trips/{id}/fixed-plans` | Add a fixed plan (up to 15 per trip). Place details are looked up from place_id. |
| PUT | `/api/trips/{id}/fixed-plans/{planId}` | Replace a fixed plan and update its activities on the itinerary |
| DELETE | `/api/trips/{id}/fixed-plans/{planId}` | Delete a fixed plan and its activities |
| POST | `/api/trips/{id}/regenerate` | Regenerate itinerary. Replaces AI suggestions only; fixed plans and user or agent edits are kept. |
| POST | `/api/trips/{id}/activities/bulk` | Add many activities in one call (save_itinerary). Append only; nothing is saved if any activity is invalid |
| GET | `/api/trips/{id}/intelligence` | Plan alerts (opening hours, holidays, travel, duplicates, overlaps, pace) plus travel legs and weather. get_trip_alerts returns the alerts |
| GET | `/api/trips/{id}/activities` | Get trip activities |
| POST | `/api/trips/{id}/activities` | Add activity |
| PUT | `/api/trips/{id}/activities/{activityId}` | Update activity |
| DELETE | `/api/trips/{id}/activities/{activityId}` | Delete activity |
| GET | `/api/users/me/preferences` | Get user preferences |
| PUT | `/api/users/me/preferences` | Update user preferences |
| GET | `/api/airports` | Search airports by IATA code, city or name (public, no auth) |
| GET | `/api/trips/{id}/concierge/state` | Get personal Concierge state for the authenticated traveler |
| PATCH | `/api/trips/{id}/concierge/settings` | Update personal Concierge settings |
| POST | `/api/trips/{id}/concierge/location` | Share a foreground GPS sample |
| DELETE | `/api/trips/{id}/concierge/location` | Clear personal location and stop sharing |
| POST | `/api/trips/{id}/concierge/events` | Report a personal status event (idempotent by client_event_id) |
| POST | `/api/trips/{id}/concierge/evaluate` | Request an evaluation (1/min/user/trip) |
| POST | `/api/trips/{id}/concierge/recommendations/{rid}/respond` | Dismiss, keep plan, or snooze a personal recommendation |
| POST | `/api/trips/{id}/concierge/recommendations/{rid}/apply` | Atomically apply a validated recovery option (editors only) |
| POST | `/api/trips/{id}/concierge/recommendations/{rid}/undo` | Undo an applied option if the trip revision is unchanged |
| GET | `/api/users/me/push-subscriptions` | List this user's Web Push subscriptions (no p256dh/auth in the response) |
| POST | `/api/users/me/push-subscriptions` | Create or update a Web Push subscription for the authenticated user |
| GET | `/api/public/trips/{token}` | Get shared trip (no auth) |
| GET | `/api/community/listings` | Browse live Community Hub listings (no auth) |
| GET | `/api/community/listings/{id}` | Get a live Community Hub listing (no auth) |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/goyondo-run/openapi/_original/goyondo-run-api-openapi.json
- **JSONSchema** — https://artifacts.apis.io/goyondo-run/json-schema/goyondo-run-trip-create-schema.json
- **JSONSchema** — https://artifacts.apis.io/goyondo-run/json-schema/goyondo-run-agent-task-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/goyondo-run/json-schema/goyondo-run-device-auth-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/goyondo-run/json-schema/goyondo-run-device-auth-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/goyondo-run/json-schema/goyondo-run-location-schema.json
- **JSONSchema** — https://artifacts.apis.io/goyondo-run/json-schema/goyondo-run-device-token-response-schema.json

## Other Goyondo APIs (1)

- [Goyondo API](https://apis.io/apis/goyondo-run/goyondo-api/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/goyondo-run/goyondo-api-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/goyondo-run/.