---
title: "Add import"
method: POST
path: "/accounts/import"
tags: ["Account Management"]
---

# Add import

`POST /accounts/import`

## Request

- Base URL: `https://api.quiva.ai`
- URL: `https://api.quiva.ai/accounts/import`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/quivaworks/apis/quiva-ai-gateway/docs/accounts/import/post.ts> (a function with typed inputs; its response is checked against the schema)

Adds a new import to the account.
- When an account adds an import, it's essentially creating a mapping that allows it to access and utilize resources (such as data streams or services) that are exported by another account. This request creates a trust relationship between accounts where one account can consume resources produced by another.

## Request body

- ImportRequest
  - `import` object, required
    - `name` string, required: Unique name for the import within the account
    - `subject` string, required: Subject pattern to be imported
    - `account` string, required: Account from which the resource is being imported
    - `token_position` integer: Optional parameter for authentication handling

## Response `200`

Import added successfully

- SuccessResponse
  - `message` string

## Other responses

- `400`: Bad request
- `401`: Unauthorized

---

[API](https://skmtc.dev/quivaworks/apis/quiva-ai-gateway.md) - [All operations](https://skmtc.dev/quivaworks/apis/quiva-ai-gateway/llms.txt) - [OpenAPI document](https://skmtc.dev/quivaworks/apis/quiva-ai-gateway/revisions/700eb1ace61a?raw)