TravelyfeHelp
المطورونReferenceImports

Import From Media

POST
/v1/imports/media

Builds an itinerary from the traveller's own images, videos or PDFs. The client turns each into still frames (a video's sampled frames, an album's images, a PDF's pages) and sends them as base64 JPEGs; kind says whether they came from a video or an album.

Requires Travelyfe Pro (subscriptionRequired otherwise). Each import counts towards the traveller's allowance for the billing period; a link someone already imported costs nothing. An assistant connected over MCP reads a page, PDF or images itself and calls create_itinerary; for a video it sends the traveller to Import in the Travelyfe app.

Only available to the Travelyfe apps. Tokens issued to other apps receive forbidden.

AuthorizationBearer <token>

A Travelyfe access token.

In: header

Header Parameters

Idempotency-Key?string

A unique key per logical request. Retrying with the same key and body replays the first response instead of repeating the write.

Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/imports/media" \  -H "Content-Type: application/json" \  -d '{    "frames": [      {        "base64": "string"      }    ]  }'
{  "preview": {    "title": "string",    "destination": "string",    "origin": "string",    "summary": "string",    "center": {      "latitude": 0,      "longitude": 0    },    "startDate": "2019-08-24T14:15:22Z",    "tags": [      "string"    ],    "bestSeason": "string",    "homeCurrency": "string",    "days": [      {        "id": "string",        "title": "string",        "summary": "string",        "imageURL": "http://example.com",        "stops": [          {            "id": "string",            "name": "string",            "address": "string",            "category": "string",            "coordinate": {              "latitude": 0,              "longitude": 0            },            "startTime": "string",            "durationMinutes": 0,            "note": "string",            "phone": "string",            "bookingURL": "http://example.com"          }        ]      }    ],    "packing": [      {        "id": "string",        "name": "string",        "quantity": 0,        "category": "string",        "isPacked": true      }    ],    "expenses": [      {        "id": "string",        "title": "string",        "amount": 0,        "currency": "string",        "date": "2019-08-24T14:15:22Z",        "category": "string"      }    ]  },  "source": {    "url": "string",    "author": "string",    "confidence": 0,    "stops": 0,    "placed": 0  }}