---
title: "PUT /addresses/{id}"
method: PUT
path: "/addresses/{id}"
---

# PUT /addresses/{id}

`PUT /addresses/{id}`

## Request

- Base URL: `https://api.useanima.sh/v1`
- URL: `https://api.useanima.sh/v1/addresses/{id}`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

## Path parameters

- `id` string, required: Address identity identifier

## Request body

- object: Input for updating an existing address identity
  - `agentId` union, required: Agent identifier that owns this address
    - string
    - string
  - `type` 'BILLING' | 'SHIPPING' | 'MAILING' | 'REGISTERED': Updated address type
  - `label` string: Updated label
  - `street1` string: Updated primary street address line
  - `street2` string: Updated secondary street address line
  - `city` string: Updated city name
  - `state` string: Updated state or province
  - `postalCode` string: Updated postal or ZIP code
  - `country` string: Updated 2-character ISO 3166-1 alpha-2 country code
  - `isPrimary` boolean: Set as primary address for this type

## Response `200`

OK

- object: Full address identity record
  - `id` string, required: Unique address identity identifier
  - `agentId` string, required: Agent that owns this address
  - `orgId` string, required: Organization the address belongs to
  - `type` 'BILLING' | 'SHIPPING' | 'MAILING' | 'REGISTERED', required: Address type
  - `label` string, nullable, required: User-defined label
  - `street1` string, required: Primary street address line
  - `street2` string, nullable, required: Secondary street address line
  - `city` string, required: City name
  - `state` string, required: State or province
  - `postalCode` string, required: Postal or ZIP code
  - `country` string, required: 2-character ISO country code
  - `validated` boolean, required: Whether the address has been validated
  - `validatedAt` string, date-time, nullable, required: Timestamp when the address was validated
  - `provider` string, nullable, required: Validation provider name
  - `metadata` object, nullable, required: Additional metadata
  - `isPrimary` boolean, required: Whether this is the primary address for its type
  - `createdAt` string, date-time, required: Timestamp when the address was created
  - `updatedAt` string, date-time, required: Timestamp when the address was last updated

---

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