Reiseplanen din.
Også i verktøyene dine.

1. Aktiver API i Triivl

   Åpne Innstillinger → API og MCP. Slå på API, velg dine egne turer og aktiver rettighetene du ønsker. Lagre innstillingene.

2. Opprett en API-nøkkel

   Gi tilkoblingen et navn og kopier nøkkelen når den vises. Nøkkelen vises bare én gang og varer i opptil 90 dager. Den nye innstillingssiden må være installert i appen.

3. La appen synkronisere, og les turene

   Hold appen åpen mens de valgte turene synkroniseres. Bruk nøkkelen som Bearer-token i forespørselen.

# Sett nøkkelen lokalt. Ikke legg den i kode eller Git.
export TRIIVL_API_KEY='DIN_API_NOKKEL'

curl 'https://api.triivl.app/v1/trips' \
  --header "Authorization: Bearer $TRIIVL_API_KEY"

{
  "trips": [
    {
      "id": "e27a8846-c0c9-42e5-a308-d35c060e336e",
      "title": "Helg i Ålesund",
      "kind": "personal",
      "startDay": "2026-11-06",
      "endDay": "2026-11-08",
      "deletedAt": null,
      "revision": "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef",
      "syncedAt": "2026-10-14T19:10:00.000Z"
    }
  ]
}

Alle ID-er, datoer og revisjoner på denne siden er eksempeldata. Bruk ID og revision fra din egen respons.

API og MCP har hvert sitt oppsett. Begge er av som standard. En API-nøkkel gir tilgang til REST, mens en godkjent MCP-tilkobling gir tilgang til MCP. Appens innloggingstoken kan ikke brukes som integrasjonsnøkkel.

Utvidede innstillinger utvider ikke automatisk en eksisterende nøkkel eller tilkobling. Opprett en ny nøkkel eller godkjenn MCP-tilkoblingen på nytt for å gi flere rettigheter. Tilgang kontrolleres ved hvert kall, og kan trekkes tilbake i appen.

Dokumenter, bilder, kvitteringer, private notater, seter, nøyaktige adresser, koordinater og pakkelister er utelatt fra dette API-et.

Alle REST-kall under krever Authorization: Bearer DIN_API_NOKKEL. {tripId} er ID-en fra turresponsen.

export TRIP_ID='ID_FRA_TURLISTEN'

curl "https://api.triivl.app/v1/trips/$TRIP_ID" \
  --header "Authorization: Bearer $TRIIVL_API_KEY"

REQUEST_ID="$(uuidgen)"

curl --request POST 'https://api.triivl.app/v1/trips' \
  --header "Authorization: Bearer $TRIIVL_API_KEY" \
  --header 'Content-Type: application/json' \
  --data "{
    \"requestId\": \"$REQUEST_ID\",
    \"trip\": {
      \"title\": \"Helg i Ålesund\",
      \"kind\": \"personal\",
      \"startDay\": \"2026-11-06\",
      \"endDay\": \"2026-11-08\"
    }
  }"

export REVISION='REVISJON_FRA_GET_TRIP'

REQUEST_ID="$(uuidgen)"

curl --request PATCH "https://api.triivl.app/v1/trips/$TRIP_ID" \
  --header "Authorization: Bearer $TRIIVL_API_KEY" \
  --header 'Content-Type: application/json' \
  --data "{
    \"requestId\": \"$REQUEST_ID\",
    \"expectedRevision\": \"$REVISION\",
    \"trip\": { \"title\": \"Langhelg i Ålesund\" }
  }"

REQUEST_ID="$(uuidgen)"

curl --request DELETE "https://api.triivl.app/v1/trips/$TRIP_ID" \
  --header "Authorization: Bearer $TRIIVL_API_KEY" \
  --header 'Content-Type: application/json' \
  --data "{
    \"requestId\": \"$REQUEST_ID\",
    \"expectedRevision\": \"$REVISION\"
  }"

Reisepunkter er fly, hotell, leiebil og andre aktiviteter i en tur. Nye punkter blir ideer som standard. Sett planningState: "confirmed" for å legge punktet i planen. API-et bestiller eller kjøper ingenting.

REQUEST_ID="$(uuidgen)"

curl --request POST "https://api.triivl.app/v1/trips/$TRIP_ID/items" \
  --header "Authorization: Bearer $TRIIVL_API_KEY" \
  --header 'Content-Type: application/json' \
  --data "{
    \"requestId\": \"$REQUEST_ID\",
    \"expectedRevision\": \"$REVISION\",
    \"item\": {
      \"type\": \"lodging\",
      \"title\": \"Hotell i Ålesund\",
      \"city\": \"Ålesund\",
      \"planningState\": \"idea\",
      \"startDate\": \"2026-11-06T15:00:00+01:00\",
      \"endDate\": \"2026-11-08T11:00:00+01:00\",
      \"startTimeZoneID\": \"Europe/Oslo\",
      \"endTimeZoneID\": \"Europe/Oslo\"
    }
  }"

{
  "requestId": "c90d02d6-dcd4-479a-8cd3-d02c8df1dcf1",
  "expectedRevision": "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef",
  "item": { "title": "Hotel Brosundet", "planningState": "confirmed" }
}

En skriverespons med 202 Accepted betyr at forespørselen er lagt i kø. Den er først lagret i appen når status er applied. Appen kontrollerer gjeldende rettigheter og revisjon før lagring.

export REQUEST_ID='ID_FRA_SKRIVERESPONSEN'

curl "https://api.triivl.app/v1/trip-commands/$REQUEST_ID" \
  --header "Authorization: Bearer $TRIIVL_API_KEY"

Trygg gjentakelse

Lag en ny UUID for hver ny endring, for eksempel med uuidgen. Ved nettverksfeil gjentar du samme forespørsel med samme requestId, samme body og samme nøkkel. Ikke generer en ny ID ved et slikt nytt forsøk: behold REQUEST_ID og gjenta bare curl-kallet, ikke linjen med uuidgen. Ulik body eller tilkobling med samme ID avvises.

Det kan bare være én ventende/påbegynt endring per tur. Vent på resultatet og les turens nye revisjon før neste endring. Ventende forespørsler utløper etter 24 timer. Statusoppføringer beholdes i opptil 90 dager.

Tur · trip

Reisepunkt · item

Ukjente felter avvises. ID-er er UUID-er. revision er 64 heksadesimale tegn. syncedAt viser når backend sist mottok kopien, og er ikke en garanti for at en lukket app har sendt sine siste endringer.

Bruk en klient som støtter MCP med Streamable HTTP og OAuth. Legg til Triivls serveradresse, og godkjenn tilgangen i appen.

https://api.triivl.app/mcp

1. Aktiver MCP i appen

   Slå på MCP og velg rettighetene under Innstillinger → API og MCP. «Alle egne turer» er standard og inkluderer nye turer. Velg «Velg enkelte turer» for å begrense tilgangen. API trenger ikke å være aktivert. Bookingreferanser er et eget tilvalg.

2. Legg til serveren i AI-klienten

   Velg en ekstern MCP-server, bruk adressen over og start klientens OAuth-innlogging.

3. Godkjenn tilkoblingen i Triivl

   Godkjenningssiden åpner appen. Kontroller klientens navn og rettighetene før du godkjenner. Hvis lenken ikke åpner appen, kan forespørselskoden fra siden legges inn manuelt i innstillingene. Forespørselen varer i fem minutter.

Pågående tur og enkeltpunkter

Bruk get_agenda for «hva er neste?» og «i morgen». Ett kall gir pågående tur, neste aktivitet og bekreftede punkter for datoen, også punkter uten tur. Tider kommer ferdig i lokale tidssoner. Et fly som lander kl. 11:00 kan gi et forslag om taxi kl. 11:30; dette er minst 30 minutters planleggingsmargin, avrundet opp til nærmeste kvarter, ikke en bestilling.

create_item kan brukes uten tripId. Punktet opprettes som idé uten å lage en kunstig tur. assign_item knytter punktet til en tur senere, eller fjerner tilknytningen med destinationTripId: null. Begge sider krever endringsrettighet og gjeldende revisjon. «Alle egne turer» inkluderer egne punkter uten tur. Ved enkeltutvalg har «Punkter uten tur» sitt eget tilvalg.

Smartere lesing og skriving

Verktøyene regner ut svarene deterministisk fra de synkroniserte kopiene. Det brukes ingen KI-modell, ingen nye data lastes opp, og alle verktøy følger rettighetene og turutvalget du har valgt. Bookingreferanser vises bare med eget tilvalg; seter, adresser og notater er aldri med.

• get_agenda gir nå også derived per aktivitet: minutter til start (startsInMinutes), turdag («Dag 2 av 3»), departsInMinutes og arrivesInMinutes for fly, og innsjekk/utsjekk for overnatting. conflicts varsler om overlapp og trange omstigninger. Eksisterende felt er uendret. Live flystatus er ikke med.
• search_items søker i tittel, undertittel, by, fra, til og flynummer, med valgfritt datointervall, type og tur. Resultatet er rangert og begrenset med limit.
• check_plan kontrollerer én tur: netter uten overnatting, overlappende punkter, trange omstigninger, transport som ender et annet sted enn neste punkt starter (bare når begge steder er kjent og kan sammenlignes), punkter uten tid og antall ubekreftede idéer. summarize_trip gir en kort oversikt med dager, byer i rekkefølge og antall per type.
• create_item og assign_item returnerer hints ved siden av den køede endringen: possibleDuplicates og, uten tur, suggestedTrips der datoen ligger i eller en dag fra turen. Dette er forslag. Ingenting tildeles eller endres automatisk. Uten lesetilgang gir hints bare checked: false.
• parse_booking_text leser innlimt bekreftelsestekst med Triivls eksisterende regelbaserte importleser og foreslår punkter i samme form som create_item. Verktøyet lagrer og køer ingenting; chatten viser forslagene og kaller create_item etter at du har sagt ja. Fly bruker flyplassenes tidssoner; for andre steder sendes timeZone med.

Klienten får bare tilbud om verktøyene den har lov til å bruke. Skriveverktøyene bruker den samme køen og revisjonskontrollen som REST. Chatklienten må bruke get_change_status for å kontrollere at endringen er lagret.

Tilgang til en ekstern AI-klient betyr at denne klienten mottar dataene du tillater. Du kan koble den fra i appen når som helst.

Triivl støtter offentlige klienter uten klienthemmelighet, eksakte redirect-URI-er og Authorization Code med PKCE S256. Klienter bør lese discovery-metadata framfor å hardkode oppsettet.

MCP bruker stateless HTTP POST med JSON-respons. GET og DELETE på /mcp gir 405; serveren bruker ikke SSE eller vedvarende MCP-sesjoner. Uautorisert POST gir 401 med en WWW-Authenticate-header som peker til ressursmetadata.

{
  "error": {
    "code": "revision_conflict",
    "message": "Trip has changed. Read its current revision."
  }
}

Ved valg av enkelte turer: opptil 1 000 valgte turer per kanal. MCP med «Alle egne turer» har ingen slik utvalgsgrense. Maksimalt 1 000 punkter per tur. Nøkkel-/klientnavn er opptil 100 tegn. Private integrasjonsresponser har Cache-Control: no-store. Leseresponser er synkroniserte kopier; kontroller syncedAt.

Lister er sidedelt: GET /v1/items og list_items svarer med høyst 100 elementer (limit, maks 500) fra offset, ordnet etter start, med total, truncated og nextOffset; en turs elementer sidedeles likt med itemLimit og itemOffset. Alt MCP kan lese finnes også som REST: GET /v1/items/search, GET /v1/trips/{id}/plan, GET /v1/trips/{id}/summary og POST /v1/booking-text, med samme rettigheter som verktøyene.

Last ned OpenAPI 3.1-spesifikasjonen for komplette skjemaer, sikkerhetsoppsett og endepunkter. Den inkluderer også appens egne backend-endepunkter; disse bruker appinnlogging og er ikke tilgjengelige med en integrasjonsnøkkel.