---
title: "Update Agent Metadata"
method: PUT
path: "/v1/projects/{project_id}/agents/{agent_id}"
tags: ["configurations"]
---

# Update Agent Metadata

`PUT /v1/projects/{project_id}/agents/{agent_id}`

Updates the metadata associated with an agent configuration. The config itself is immutable—to change the configuration, delete the existing agent and create a new one.

## Path parameters

- `project_id` string, required
- `agent_id` string, required

## Headers

- `Authorization` string, required

## Request body

- UpdateAgentMetadataV1Request — Request body for updating agent configuration metadata
  - `metadata` object, required — A map of string key-value pairs to associate with this agent configuration

## Response `200`

Agent configuration updated

- AgentConfigurationV1 — A reusable agent configuration
  - `agent_id` string, required — The unique identifier of the agent configuration
  - `config` AgentConfigurationV1Config, required — The agent configuration object
  - `metadata` object — A map of arbitrary key-value pairs for labeling or organizing the agent configuration
  - `created_at` string, date-time — Timestamp when the configuration was created
  - `updated_at` string, date-time — Timestamp when the configuration was last updated

## Other responses

- `400` — Invalid Request

---

[API](https://skmtc.net/deepgram/apis/rest-api.md) · [All operations](https://skmtc.net/deepgram/apis/rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/deepgram/rest-api/versions/bd7ba5c18a6b/schema)