Plan a trip. Connect an assistant.

Things to ask

{
  "id": "f10b92d5-3a8c-4ed3-94c9-b94c5a3b0a11",
  "title": "London trip",
  "updated_at": "2026-09-30T12:00:00.123456+00:00",
  "legs": [
    {
      "id": "6c9b0e61-6475-4fd1-9b09-d81073517940",
      "type": "activity",
      "order_index": 1,
      "updated_at": "2026-09-30T11:59:00.654321+00:00",
      "leg_data": {
        "activity_name": "Client meeting",
        "location": {
          "address": "QEII Centre, Broad Sanctuary, London SW1P 3EE, UK"
        },
        "start_time": {
          "timestamp": "2026-10-12T09:00:00+01:00",
          "timezone": {
            "timezoneId": "Europe/London"
          }
        },
        "end_time": {
          "timestamp": "2026-10-12T11:00:00+01:00",
          "timezone": {
            "timezoneId": "Europe/London"
          }
        },
        "booking_reference": "MEETING-EXAMPLE"
      }
    }
  ]
}

{
  "itinerary_id": "f10b92d5-3a8c-4ed3-94c9-b94c5a3b0a11",
  "leg_id": "6c9b0e61-6475-4fd1-9b09-d81073517940",
  "expected_updated_at": "2026-09-30T12:00:00.123456+00:00",
  "expected_leg_updated_at": "2026-09-30T11:59:00.654321+00:00",
  "type": "activity",
  "leg_data": {
    "activity_name": "Client meeting",
    "location": {
      "address": "QEII Centre, Broad Sanctuary, London SW1P 3EE, UK"
    },
    "start_time": {
      "timestamp": "2026-10-12T10:30:00+01:00",
      "timezone": {
        "timezoneId": "Europe/London"
      }
    },
    "end_time": {
      "timestamp": "2026-10-12T11:00:00+01:00",
      "timezone": {
        "timezoneId": "Europe/London"
      }
    },
    "booking_reference": "MEETING-EXAMPLE"
  }
}

Take the trip to your calendar

Open a saved itinerary and select Download calendar (.ics), then import the file into your calendar app. Save or discard any edits first. An approved read connection can also request export_itinerary_calendar with the trip ID.

This is a snapshot, not a subscription or automatic sync. After changing a trip, export it again and review your calendar for duplicate entries. Transit entries are estimates; pending routes and items with invalid dates are omitted with warnings.

The file contains travel locations and schedule details. Anyone you share the file or imported calendar with may see them. Review the destination calendar's visibility before importing. Offline downloads use your cached saved trip.

Tool reference

Tools require an authenticated, active account and an approved connection. Your host discovers the full input schemas from the server. This guide describes the current contracts.

Writes need explicit trip IDs where applicable. Timed items need timestamps with offsets. Potniq assigns IDs and ordering; do not submit generated transit items. If a write outcome is uncertain, reread the trip before retrying to avoid duplicate items.

Your data. Your permission.

When a connection needs attention

Authentication fails

Try reconnecting once and review account access. If it still fails, stop retrying and report the connection state to [email protected]. Do not share access tokens or authorization URLs.

The assistant cannot write

A read-only connection cannot change your trips. Request write access through a supported client, approve it in Potniq, then reconnect. Never ask an assistant to approve consent for you.

The trip or location is ambiguous

Choose a specific candidate. Clarify dates, local times and venues rather than letting the assistant invent missing facts.

An edit returns REVISION_CONFLICT

The trip or leg changed since your last read, so this stale edit was rejected. Reread it, reconcile the intended change with the latest facts and rebuild the payload. Preserve unrelated updates and ask about competing changes. Copy the new revision timestamps unchanged; do not attach them to the old payload or retry automatically.

An edit is missing its preconditions

Read the trip with get_itinerary. Both edit tools require the trip's updated_at as expected_updated_at; update_leg also requires the selected leg's updated_at as expected_leg_updated_at. Never invent, round or reformat these timestamps.

The tool times out after a change

Read the trip again before retrying. A failed response does not establish that the write failed; creating the same item twice can duplicate it.

Transit is missing or still calculating

Check that travel items have usable locations and dates, then refresh the trip. Review unresolved legs in the web app before relying on departure times.