---
title: "CreateManagedResource Managed Resources V2"
method: POST
path: "/v2/managed_resources"
tags: ["Managed Resources V2"]
---

# CreateManagedResource Managed Resources V2

`POST /v2/managed_resources`

Called by external providers such as Terraform, this can 'claim' an incident.io resource as being managed externally.

## Request body

- ManagedResourcesV2CreateManagedResourceRequestBody
  - `annotations` object, required — Annotations that track metadata about this resource
  - `resource_id` string, required — The ID of the related resource
  - `resource_type` 'escalation_path' | 'schedule' | 'workflow', required — The type of the related resource

## Response `200`

OK response.

- ManagedResourcesV2CreateManagedResourceResponseBody
  - `managed_resource` ManagedResourceV2, required
    - `annotations` object, required — Annotations that track metadata about this resource
    - `managed_by` 'dashboard' | 'terraform' | 'external', required — How is this resource managed
    - `resource_id` string, required — The ID of the related resource
    - `resource_type` 'escalation_path' | 'schedule' | 'workflow', required — The type of the related resource
    - `source_url` string — The url of the external repository where this resource is managed (if there is one)

---

[API](https://skmtc.net/incident/apis/incident-io.md) · [All operations](https://skmtc.net/incident/apis/incident-io/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/incident/incident-io/revisions/602fc25ddd76/schema)