---
title: "Update resource instance"
method: PUT
path: "/lifecycle-manager/resources/{modelId}/instances/{instanceId}"
tags: ["Lifecycle Manager"]
---

# Update resource instance

`PUT /lifecycle-manager/resources/{modelId}/instances/{instanceId}`

## Request

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

Updates the `name` and `description` fields of a resource instance.

## Path parameters

- `modelId` string, required: A MongoDB ObjectId
- `instanceId` string, required: A MongoDB ObjectId

## Request body

- object
  - `name` string: The name of the resource instance
  - `description` string: Free-form text describing the resource instance

## Response `200`

response

- LifecycleManagerUpdateInstanceMetadataHttpResponse200
  - `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/:modelId/instances/:instanceId/put.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)