---
title: "Import a platform config (e.g. Vapi) into Flow IR"
method: POST
path: "/api/flows/import"
tags: ["Flows"]
---

# Import a platform config (e.g. Vapi) into Flow IR

`POST /api/flows/import`

## Request

- Base URL: `https://api.wordis-bond.com`
- URL: `https://api.wordis-bond.com/api/flows/import`
- Auth: HTTP bearer

Convert a real platform flow/agent config into the canonical, diffable Flow IR. Reports the fields the IR abstracts away. Pass save:true to persist it as a new flow (version 1). The same IR is the migration surface — export it to another platform. Vapi ships in v0; Twilio Studio and Amazon Connect are the next adapters onto this IR.

## Request body

- object
  - `platform` 'vapi', required
  - `config` object, required: The platform's native flow/agent object.
  - `save` boolean
  - `name` string

## Response `200`

Imported IR

- object
  - `data` object, required
  - `error` union, required
    - object
    - string

## Other responses

- `201`: Imported + saved as a flow
- `401`: Missing, invalid, or revoked credentials.
- `422`: The request body failed validation.

---

[API](https://skmtc.dev/wordis-bond/apis/word-is-bond-voice-agent-testing-api.md) · [All operations](https://skmtc.dev/wordis-bond/apis/word-is-bond-voice-agent-testing-api/llms.txt) · [OpenAPI document](https://skmtc.dev/wordis-bond/apis/word-is-bond-voice-agent-testing-api/revisions/66c2d5480d84?raw)