Files
dashback/docs/api/routes/entity/address/update.md
2026-09-30 19:29:13 +02:00

69 lines
1.4 KiB
Markdown

# `PATCH /entity/{entityId}/address/{id}`
Protected. Requires a valid session cookie (`credentials: 'include'`).
Update entity address
Patches address fields that are present.
## Path parameters
| Param | Required | Type | Description |
|-------|----------|------|-------------|
| `entityId` | yes | integer | |
| `id` | yes | integer | |
## Body (JSON)
| Field | Required | Type | Description |
|-------|----------|------|-------------|
| `addressType` | no | string | |
| `firstName` | no | string | |
| `name` | no | string | |
| `street` | no | string | |
| `streetNumber` | no | string | |
| `zip` | no | string | |
| `city` | no | string | |
| `county` | no | string | |
```json
{
"city": "München",
"zip": "80331"
}
```
## Response `200`
Updated address
```json
{
"address": {
"id": 1,
"entityId": 1,
"firstName": "…",
"name": "…",
"street": "…",
"streetNumber": "…",
"zip": "…",
"city": "…",
"county": "…",
"addressType": "…"
}
}
```
## Errors
| Status | Description |
|--------|-------------|
| 400 | Address type required, invalid ids, or no company selected — `{"error":"…"}` |
| 401 | Unauthorized — `{"error":"…"}` |
| 403 | Not authorized — `{"error":"…"}` |
| 404 | Address, entity, or company not found — `{"error":"…"}` |
---
_Generated from `@openapi` JSDoc. Do not edit by hand — run `npm run docs:api`._