Delete a location space

Request#

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

Requires locations:lifecycle, locations:delete. 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#

No body fields are required. Omit the request body.

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 --request DELETE "https://my.assetcenter.app/api/v1/locations/123/spaces/8" \
  --header "Authorization: Bearer $ASSETCENTER_API_TOKEN" \
  --header "Accept: application/json" \
  --header "Idempotency-Key: $IDEMPOTENCY_KEY"

Response#

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

{
  "data": {
    "resource": "locations",
    "record_id": 123,
    "person_location_event_ids": [],
    "asset_event_ids": [],
    "subscription_event_ids": [],
    "todo": null,
    "space": null,
    "state": {
      "status": "active"
    }
  }
}

Behavior and constraints#

Returns a workflow result with space: null. A space containing assets cannot be deleted (409); move those assets first. Space metadata does not create timeline history.

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. 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.