---
title: "Import an instance into a resource"
method: POST
path: "/lifecycle-manager/resources/{modelIdentifier}/instances/import"
tags: ["Lifecycle Manager"]
---

# Import an instance into a resource

`POST /lifecycle-manager/resources/{modelIdentifier}/instances/import`

## Request

- Base URL: `https://example.itential.io`
- URL: `https://example.itential.io/lifecycle-manager/resources/{modelIdentifier}/instances/import`
- Auth: none declared

Imports an instance into a resource.

## Path parameters

- `modelIdentifier` union, required
  - string: A string which is formatted like an ObjectId, Distinct from an actual ObjectId.
  - string: The name of the document

## Request body

- LifecycleManagerResourceInstanceExport
  - `name` string, required: The name of the resource instance
  - `description` string, required: Free-form text describing the resource instance
  - `created` unknown, required
  - `createdBy` unknown, required
  - `lastUpdated` unknown, required
  - `lastUpdatedBy` unknown, required
  - `instanceData` LifecycleManagerResourceInstanceExportInstanceData, required: The data for the resource instance

## Response `200`

response

- LifecycleManagerImportResourceInstanceHttpResponse200
  - `data` LifecycleManagerResourceInstanceHttp
    - `_id` unknown, required
    - `name` string, required: The name of the resource instance
    - `description` string, required: Free-form text describing the resource instance
    - `modelId` unknown, required
    - `instanceData` LifecycleManagerResourceInstanceHttpInstanceData, required: The data for the resource instance
    - `lastAction` LifecycleManagerResourceInstanceHttpLastAction, required: The last action that was run on this instance
      - `_id` unknown, required
      - `executionId` unknown, required
      - `name` string, required: The name of the action
      - `type` 'import' | 'create' | 'update' | 'delete', required: The type of the action
      - `status` 'running' | 'error' | 'complete' | 'canceled' | 'paused', required: A single string describing the current activity status of this action
    - `created` unknown, required
    - `createdBy` unknown, required
    - `lastUpdated` unknown, required
    - `lastUpdatedBy` unknown, required
    - `instanceGroups` LifecycleManagerResourceInstanceHttpInstanceGroupsItems[]: The groups that this resource instance is a member of
      - `_id` string: A string which is formatted like an ObjectId, Distinct from an actual ObjectId.
      - `name` string: The name of the document

## Other responses

- `500`: Error response from API

## Changes

- **2026-10-31** `2095cc90e583`: 2 info
  - api tag `Lifecycle Manager` added
  - api tag `lifecycleManager` removed

[Operation history](https://skmtc.dev/itential/apis/itential-2/changes/lifecycle-manager/resources/:modelIdentifier/instances/import/post.md)

---

[API](https://skmtc.dev/itential/apis/itential-2.md) - [All operations](https://skmtc.dev/itential/apis/itential-2/llms.txt) - [OpenAPI document](https://skmtc.dev/itential/apis/itential-2/revisions/2095cc90e583?raw)