---
title: "Update pod"
method: PATCH
path: "/v1/pods/{pod_id}"
tags: ["pods"]
---

# Update pod

`PATCH /v1/pods/{pod_id}`

## Request

- Base URL: `https://agentlair.dev`
- URL: `https://agentlair.dev/v1/pods/{pod_id}`
- Auth: HTTP bearer

Update a pod's name, rate limits, and/or spending caps. Only platform keys (al_live_...) can update pods. Set rate_limits or spending_caps to null to remove them.

## Path parameters

- `pod_id` string, required

## Request body

- object
  - `name` string, nullable: New label for the pod. Set to null or empty string to clear.
  - `rate_limits` PodRateLimits: Request rate limits for a pod. Values must be positive integers with requests_per_minute ≤ requests_per_hour ≤ requests_per_day.
    - `requests_per_minute` integer: Maximum requests per minute
    - `requests_per_hour` integer: Maximum requests per hour
    - `requests_per_day` integer: Maximum requests per day
  - `spending_caps` SpendingCaps: Atomic USDC spending caps per calendar period (UTC). 1 USDC = 1,000,000 atomic units. Values must be positive integers with daily ≤ weekly ≤ monthly.
    - `daily` integer: Maximum atomic USDC per calendar day (UTC)
    - `weekly` integer: Maximum atomic USDC per ISO calendar week (UTC)
    - `monthly` integer: Maximum atomic USDC per calendar month (UTC)

## Response `200`

Pod updated

- object
  - `id` string
  - `name` string, nullable
  - `status` 'active' | 'suspended'
  - `rate_limits` PodRateLimits: Request rate limits for a pod. Values must be positive integers with requests_per_minute ≤ requests_per_hour ≤ requests_per_day.
    - `requests_per_minute` integer: Maximum requests per minute
    - `requests_per_hour` integer: Maximum requests per hour
    - `requests_per_day` integer: Maximum requests per day
  - `spending_caps` SpendingCaps: Atomic USDC spending caps per calendar period (UTC). 1 USDC = 1,000,000 atomic units. Values must be positive integers with daily ≤ weekly ≤ monthly.
    - `daily` integer: Maximum atomic USDC per calendar day (UTC)
    - `weekly` integer: Maximum atomic USDC per ISO calendar week (UTC)
    - `monthly` integer: Maximum atomic USDC per calendar month (UTC)
  - `updated` boolean

## Other responses

- `401`: Unauthorized
- `403`: Forbidden — pod keys cannot update pod settings
- `404`: Pod not found

---

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