---
title: "Update an Agent Variable"
method: PATCH
path: "/v1/projects/{project_id}/agent-variables/{variable_id}"
tags: ["variables"]
---

# Update an Agent Variable

`PATCH /v1/projects/{project_id}/agent-variables/{variable_id}`

Updates the value of an existing template variable

## Path parameters

- `project_id` string, required
- `variable_id` string, required

## Headers

- `Authorization` string, required

## Request body

- UpdateAgentVariableV1Request — Request body for updating an agent variable
  - `value` unknown, required

## Response `200`

Agent variable updated

- AgentVariableV1 — A template variable for agent configurations
  - `variable_id` string, required — The unique identifier of the variable
  - `key` string, required — The variable name, following the DG_<VARIABLE_NAME> format
  - `value` unknown, required
  - `created_at` string, date-time — Timestamp when the variable was created
  - `updated_at` string, date-time — Timestamp when the variable was last updated

## Other responses

- `400` — Invalid Request

## Changes

> 9 revisions in range; 1 could not be searched.

- **2026-08-15** `76f89c68dacf` — 2 info
  - api tag `variables` added
  - api tag `voiceAgent > variables` removed
- **2026-08-12** `c761ed1f371e` — 2 info
  - api tag `voiceAgent > variables` added
  - api tag `variables` removed
- **2026-08-06** `bd7ba5c18a6b` — 2 info
  - api tag `variables` added
  - api tag `voiceAgent > variables` removed

[Change history](https://skmtc.dev/deepgram/apis/rest-api/changes/v1/projects/:project_id/agent-variables/:variable_id/patch.md)

---

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