AssetCenter
Sign in Get started - it's free!

↑ ↓ to navigate · ↵ to open See all results
PUT /api/v1/asset-events/{event}/position

Reorder an asset event definition

Reorder an asset event definition in the organization attached to your public API key.

Last updated

Request

PUT /api/v1/asset-events/{event}/position

Requires asset-events:update and an active token creator who remains an administrator of the token’s organization. Event setup and permissions.

Send Authorization: Bearer YOUR_API_TOKEN and Accept: application/json.

Path parameters

event integer Required
Definition ID from list definitions. Use the returned replacement ID after customizing a shared default.

Query parameters

This endpoint does not use query parameters.

Request body

Send JSON with Content-Type: application/json.

Field Type Required Description
position integer Yes Zero-based destination within this definition’s group, from 0 to the group count minus 1. Hidden definitions count too.

Retry protection

Requires Idempotency-Key: 8–128 letters, numbers, dots, underscores, colons, or hyphens. Reuse the same method, path, body, and key for retries. Successful responses are remembered for 24 hours per token. Conflicting key reuse returns 409. Idempotency and retries.

Example

Replace the example ID with an ID from your organization. Set ASSETCENTER_API_TOKEN as described in the quick start.

cURL / Bash 
curl --request PUT "https://my.assetcenter.app/api/v1/asset-events/42/position" \
  --header "Authorization: Bearer $ASSETCENTER_API_TOKEN" \
  --header "Accept: application/json" \
  --header "Idempotency-Key: $(uuidgen)" \
  --header "Content-Type: application/json" \
  --data '{"position":0}'

For retries, reuse the original key instead of generating another UUID.

Response

200 OK. Illustrative values; IDs and positions will differ.

JSON 
{
  "data": {
    "id": 42,
    "group": "lifecycle",
    "name": "Inspection",
    "icon": "box",
    "color": "gray",
    "visible": true,
    "is_system": false,
    "is_global": false,
    "parent_id": null,
    "position": 0,
    "limit_to_categories": [],
    "cost_category_id": null,
    "can_delete": true,
    "fields": []
  }
}

Behavior and constraints

Moves the definition to the supplied zero-based position and renumbers that group consecutively. Other groups and other organizations retain their order. Shared defaults in the group are localized before their positions change, producing new definition and field IDs; the original shared rows remain unchanged. The response contains the moved definition. Refresh the group list after reordering to obtain every effective ID. Retry using the same key and original path to recover the original result.

Errors

401 means the customer token is missing, invalid, expired, or revoked, or its creator is inactive. 403 means the required permission or administrator membership is missing. 404 means the definition is unavailable in the token’s organization, including a shared ID already overridden. 422 means invalid or unsupported input. 429 means the rate limit was reached. Errors and limits. 409 means conflicting idempotency-key reuse or a protected deletion.