Settings & Offices
Manage office locations for your tenant — useful for multi-location companies.
Office Object
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| id | integer | Optional | Unique office ID |
| name | string | Optional | Office namez.B. Main Office Frankfurt |
| city | string | Optional | City |
| country | string | Optional | Country (ISO 3166-1 alpha-2)z.B. DE |
| address | string|null | Optional | Full address |
| iata_code | string|null | Optional | IATA airport code (for aviation locations)z.B. FRA |
| is_default | boolean | Optional | Is this the default office? |
| created_at | datetime | Optional | Creation timestamp |
GET /offices — Get All Offices
GEThttps://api.aeroselect.io/api/v2/external/offices
cURLBash
curl "https://api.aeroselect.io/api/v2/external/offices" \
-H "X-API-Key: ak_live_YOUR_KEY"Response 200JSON
{
"data": [
{
"id": 1,
"name": "Main Office Frankfurt",
"city": "Frankfurt am Main",
"country": "DE",
"address": "Airport City, Cargo City Süd, 60549 Frankfurt",
"iata_code": "FRA",
"is_default": true,
"created_at": "2026-01-15T10:00:00Z"
},
{
"id": 2,
"name": "Munich Base",
"city": "München",
"country": "DE",
"address": null,
"iata_code": "MUC",
"is_default": false,
"created_at": "2026-02-10T09:00:00Z"
}
]
}POST /offices — Create Office
Requires scope settings:write.
POSThttps://api.aeroselect.io/api/v2/external/offices
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| name | string | Pflicht | Office name (max. 255 characters) |
| city | string | Pflicht | City |
| country | string | Pflicht | Country (ISO 3166-1 alpha-2) |
| address | string | Optional | Full address |
| iata_code | string | Optional | IATA airport code (3 letters) |
cURLBash
curl -X POST "https://api.aeroselect.io/api/v2/external/offices" \
-H "X-API-Key: ak_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Vienna Base",
"city": "Vienna",
"country": "AT",
"iata_code": "VIE"
}'PATCH /offices/{id} — Edit Office
Requires scope settings:write.
PATCHhttps://api.aeroselect.io/api/v2/external/offices/{id}
cURLBash
curl -X PATCH "https://api.aeroselect.io/api/v2/external/offices/3" \
-H "X-API-Key: ak_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{ "name": "Vienna Hub", "address": "Vienna International Airport, 1300 Vienna-Airport" }'DELETE /offices/{id} — Delete Office
Requires scope settings:write.
DELETEhttps://api.aeroselect.io/api/v2/external/offices/{id}
Default office is protected
The default office (
is_default: true) cannot be deleted. Assign the default property to another office before deleting the current default office.cURLBash
curl -X DELETE "https://api.aeroselect.io/api/v2/external/offices/3" \
-H "X-API-Key: ak_live_YOUR_KEY"Response 200JSON
{ "message": "Office deleted." }