---
title: "Import an Agent bundle (v2)"
method: POST
path: "/v2/agents/import"
tags: ["Agents"]
---

# Import an Agent bundle (v2)

`POST /v2/agents/import`

## Request

- Base URL: `https://api.chat.ethora.com`
- URL: `https://api.chat.ethora.com/v2/agents/import`
- Auth: HTTP bearer

Creates a new Agent under the calling user with a fresh EOA-style
address. Visibility is forced to `private` regardless of the
bundle - the importer must deliberately re-publish.

Body shapes:
- `application/json`: body IS the bundle.
- `multipart/form-data`: field `bundle` is a `.zip` containing
  `bundle.json`.

Pass `?ownerAppId=` to attribute the new agent to a specific home
app for analytics; otherwise falls back to the caller's appId.

## Request body

- object

## Response `201`

imported

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `422`: bundle missing, malformed, or wrong schemaVersion
- `500`: Internal Server Error

---

[API](https://skmtc.dev/ethora/apis/platform-api.md) · [All operations](https://skmtc.dev/ethora/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ethora/apis/platform-api/revisions/01b6e64378ee?raw)