AssetCenter
Sign in Get started - it's free!

↑ ↓ to navigate · ↵ to open See all results
PATCH /api/v1/locations/{record}/spaces/{space}

Update a location space

Change only the supplied fields on this space.

Last updated

Request

PATCH /api/v1/locations/{record}/spaces/{space}

Requires locations:lifecycle. See token permissions. Every listed permission is required for this endpoint.

Send Authorization: Bearer YOUR_API_TOKEN and Accept: application/json. Send request bodies as JSON with Content-Type: application/json. This workflow write requires Idempotency-Key. Reuse the same key only when retrying the same action.

record is the numeric location ID in your token’s organization. space is the numeric space ID belonging to this location; obtain it from the space list.

Request body

Field Type Usage
name string Required on creation; optional on PATCH, but cannot be empty. Up to 255 characters.
description string or null Optional. Up to 255 characters.
type string or null Optional. Up to 255 characters.
address string or null Optional. Up to 255 characters.

Example

Set ASSETCENTER_API_TOKEN as described in the quick start. Replace example record and option IDs with values from your organization. Set IDEMPOTENCY_KEY to a new UUID for this action; keep it for retries.

cURL / Bash 
curl --request PATCH "https://my.assetcenter.app/api/v1/locations/123/spaces/8" \
  --header "Authorization: Bearer $ASSETCENTER_API_TOKEN" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: $IDEMPOTENCY_KEY" \
  --data '{"name":"Storage room"}'

Response

200 OK. Illustrative response structure. Event arrays, to-do/space values, and current state depend on the action and the record.

JSON 
{
  "data": {
    "resource": "locations",
    "record_id": 123,
    "person_location_event_ids": [],
    "asset_event_ids": [],
    "subscription_event_ids": [],
    "todo": null,
    "space": {
      "created_at": "2026-09-07T16:00:00.000000Z",
      "updated_at": "2026-09-07T16:00:00.000000Z",
      "id": 8,
      "location_id": 123,
      "name": "Storage room",
      "description": "Ground floor",
      "type": "Room",
      "address": null
    },
    "state": {
      "status": "active"
    }
  }
}

Behavior and constraints

Supply at least one supported field. The child must belong to this record. Space metadata changes do not add a timeline event.

Errors

401 means the token is missing, expired, revoked, or not a customer API token. 403 means a required permission or administrator access is missing. 404 means the record or child record is unavailable in this organization. 422 identifies invalid or unsupported input; inspect the errors object when present. 409 indicates a conflicting state or concurrent change; inspect the message and refresh the record before deciding how to proceed. Reusing an idempotency key with a different method, path, or body also returns 409. 429 means a rate limit was reached. See error handling and rate limits.