---
title: "Save Reference Matches"
method: PUT
path: "/admin/managed-resources/targets/{target_id}/references"
tags: ["admin", "admin:managed-resources"]
---

# Save Reference Matches

`PUT /admin/managed-resources/targets/{target_id}/references`

## Request

- Base URL: `https://platform.tracecat.com/api`
- URL: `https://platform.tracecat.com/api/admin/managed-resources/targets/{target_id}/references`
- Auth: API key in cookie `fastapiusersauth`

Save reference matches; later version bumps reuse them.

## Path parameters

- `target_id` string, uuid, required

## Request body

- ManagedReferenceMatchesUpdate: Replace a target's saved reference matches.
  - `matches` ManagedReferenceMatchItem[]
    - `reference_kind` 'model' | 'mcp_integration' | 'secret_store', required: Kind of source-side reference a target workspace must resolve locally.
    - `source_key` string, required
    - `resolved_id` string, uuid, nullable: Target resource id. Null leaves a secret store unlinked.

## Response `200`

Successful Response

- ManagedReferenceMatchItem[]
  - `reference_kind` 'model' | 'mcp_integration' | 'secret_store', required: Kind of source-side reference a target workspace must resolve locally.
  - `source_key` string, required
  - `resolved_id` string, uuid, nullable: Target resource id. Null leaves a secret store unlinked.

## Other responses

- `422`: Validation Error

---

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