Developers · API v1
Build with your asset data.
Connect your tools to AssetCenter. Read your inventory, automate assignments, and record the work that happens to every asset.
https://my.assetcenter.app/api/v1
JSON · Bearer tokens · 227 endpoint pages
Download AssetCenter CLI
v0.1.0Your inventory, in your terminal. Choose your operating system and processor. Each download is a standalone executable.
Install from your terminal
On macOS or Linux, run this command. The installer detects your processor, verifies the SHA-256 checksum, and installs to ~/.local/bin without sudo.
curl -fsSL https://assetcenter.app/install.sh | sh
Follow the PATH instructions printed by the installer, then run assetcenter auth login. View the installer script.
macOS
6.5 MB
7.0 MB
Linux
7.3 MB
6.8 MB
Windows
7.1 MB
6.5 MB
Install and connect the CLI
1. Install your download
On macOS or Linux, replace the filename below with your download. This installs the command as assetcenter without administrator access.
mkdir -p ~/.local/bin
install -m755 ~/Downloads/assetcenter-linux-amd64 ~/.local/bin/assetcenter
export PATH="$HOME/.local/bin:$PATH"
Add the PATH line to your shell profile to keep it available in new terminals.
On Windows, replace the filename with your download, then run these commands in PowerShell:
New-Item -ItemType Directory -Force "$HOME\bin"
Move-Item "$HOME\Downloads\assetcenter-windows-amd64.exe" "$HOME\bin\assetcenter.exe"
$env:Path = "$HOME\bin;$env:Path"
Add your bin folder to your user PATH in Windows environment settings for new terminals.
2. Create a token and log in
An organization administrator can create a token in Settings → API Access. Choose the permissions your workflow needs.
assetcenter auth login
Paste the token at the prompt. The CLI connects to my.assetcenter.app automatically and stores your credentials locally.
3. Explore and automate
Read inventory, inspect records, and use JSON output in scripts. Write commands follow your token’s permissions.
assetcenter assets list
assetcenter assets show 123
assetcenter assets list --json
assetcenter --help
Use --help on any command to see its options.
API developer guide
Start with your first request, then find the exact endpoint for your integration. Each reference includes permissions, parameters, examples, and response details.
Start building
-
Getting started
Connect your own tools to AssetCenter with an organization-scoped API token.
-
Quick start
Make your first authenticated request, read a record, and add a note with cURL.
-
Authentication and permissions
Create and manage tokens, choose permissions, and keep requests scoped to the correct organization.
-
Pagination and response formats
Read complete result sets and understand records, timestamps, and workflow responses.
-
Idempotency and retries
Retry workflow, organization, and user requests without duplicating successful changes.
-
Errors and rate limits
Interpret API errors, respect request limits, and resolve workflow conflicts.
Billing
Organizations
-
Organization API
Manage organization settings, upload logos, export data, and delete an organization with customer API tokens.
-
GET
Read organization settings
/api/v1/organizations/current -
PATCH / PUT
Update organization settings
/api/v1/organizations/{organization} -
POST
Upload an organization logo
/api/v1/organizations/{organization}/image -
DELETE
Remove an organization logo
/api/v1/organizations/{organization}/image -
GET
Download an organization export
/api/v1/organizations/{organization}/exports/{exportResource} -
DELETE
Delete an organization
/api/v1/organizations/{organization}
Users and invitations
-
Users and invitations
Manage organization membership and access with a customer API key.
-
GET
List organization users
/api/v1/users -
GET
Get an organization user
/api/v1/users/{user} -
GET
User permission options
/api/v1/users/options -
PATCH
Update user permissions
/api/v1/users/{user}/permissions -
DELETE
Remove an organization user
/api/v1/users/{user} -
GET
List organization invitations
/api/v1/invitations -
POST
Invite an organization user
/api/v1/invitations -
POST
Resend an organization invitation
/api/v1/invitations/{invitation}/resend -
DELETE
Revoke an organization invitation
/api/v1/invitations/{invitation}
Asset categories
-
Asset categories and custom fields
Manage asset category settings and field definitions with organization-scoped public API keys.
-
GET
List asset categories
/api/v1/asset-categories -
GET
Get an asset category
/api/v1/asset-categories/{category} -
GET
Get asset category options
/api/v1/asset-categories/options -
POST
Create an asset category
/api/v1/asset-categories -
PATCH
Update an asset category
/api/v1/asset-categories/{category} -
DELETE
Delete an asset category
/api/v1/asset-categories/{category} -
PUT
Reorder an asset category
/api/v1/asset-categories/{category}/position -
POST
Create an asset category field
/api/v1/asset-categories/{category}/fields -
PATCH
Update an asset category field
/api/v1/asset-categories/{category}/fields/{field} -
DELETE
Delete an asset category field
/api/v1/asset-categories/{category}/fields/{field} -
PUT
Reorder an asset category field
/api/v1/asset-categories/{category}/fields/{field}/position
Subscription categories
-
Subscription categories and custom fields
Manage subscription category settings and field definitions with organization-scoped public API keys.
-
GET
List subscription categories
/api/v1/subscription-categories -
GET
Get a subscription category
/api/v1/subscription-categories/{category} -
GET
Get subscription category options
/api/v1/subscription-categories/options -
POST
Create a subscription category
/api/v1/subscription-categories -
PATCH
Update a subscription category
/api/v1/subscription-categories/{category} -
DELETE
Delete a subscription category
/api/v1/subscription-categories/{category} -
PUT
Reorder a subscription category
/api/v1/subscription-categories/{category}/position -
POST
Create a subscription category field
/api/v1/subscription-categories/{category}/fields -
PATCH
Update a subscription category field
/api/v1/subscription-categories/{category}/fields/{field} -
DELETE
Delete a subscription category field
/api/v1/subscription-categories/{category}/fields/{field} -
PUT
Reorder a subscription category field
/api/v1/subscription-categories/{category}/fields/{field}/position
Asset event setup
-
Asset event setup
Configure acquisition, lifecycle, condition, and decommission event definitions through the public API.
-
GET
List asset event definitions
/api/v1/asset-events -
GET
Get an asset event definition
/api/v1/asset-events/{event} -
GET
Get asset event setup options
/api/v1/asset-events/options -
POST
Create an asset event definition
/api/v1/asset-events -
PATCH
Update an asset event definition
/api/v1/asset-events/{event} -
DELETE
Delete an asset event definition
/api/v1/asset-events/{event} -
PUT
Reorder an asset event definition
/api/v1/asset-events/{event}/position
Person event setup
-
Person event setup
Configure the custom events your organization logs against people, such as badge issued, through the public API.
-
GET
List person event definitions
/api/v1/person-events -
GET
Get a person event definition
/api/v1/person-events/{event} -
GET
Get person event setup options
/api/v1/person-events/options -
POST
Create a person event definition
/api/v1/person-events -
PATCH
Update a person event definition
/api/v1/person-events/{event} -
DELETE
Delete a person event definition
/api/v1/person-events/{event} -
PUT
Reorder a person event definition
/api/v1/person-events/{event}/position
Location event setup
-
Location event setup
Configure the custom events your organization logs against locations, such as fire inspection, through the public API.
-
GET
List location event definitions
/api/v1/location-events -
GET
Get a location event definition
/api/v1/location-events/{event} -
GET
Get location event setup options
/api/v1/location-events/options -
POST
Create a location event definition
/api/v1/location-events -
PATCH
Update a location event definition
/api/v1/location-events/{event} -
DELETE
Delete a location event definition
/api/v1/location-events/{event} -
PUT
Reorder a location event definition
/api/v1/location-events/{event}/position
Lookups
Assets
-
GET
List assets
/api/v1/assets -
GET
Get an asset
/api/v1/assets/{record} -
GET
Look up an asset by barcode
/api/v1/assets/scan -
GET
Asset creation options
/api/v1/assets/options -
POST
Create an asset
/api/v1/assets -
PATCH / PUT
Update an asset
/api/v1/assets/{record} -
POST / DELETE
Manage an asset image
/api/v1/assets/{record}/image -
DELETE
Delete an asset
/api/v1/assets/{record} -
GET
Assets timeline
/api/v1/assets/{record}/timeline -
GET
Get an asset timeline entry
/api/v1/assets/{record}/timeline/{type}/{entry} -
GET
Asset timeline lookup options
/api/v1/assets/{record}/timeline/{type}/{entry}/options -
POST
Manage asset timeline comments
/api/v1/assets/{record}/timeline/{type}/{entry}/comments -
PATCH
Update an asset timeline entry
/api/v1/assets/{record}/timeline/{type}/{entry} -
DELETE
Delete an asset timeline entry
/api/v1/assets/{record}/timeline/{type}/{entry}
Asset actions
-
POST
Create an asset to-do
/api/v1/assets/{record}/todos -
GET
List asset to-dos
/api/v1/assets/{record}/todos -
GET
Asset to-do assignees
/api/v1/assets/{record}/todos/options -
PATCH
Update an asset to-do
/api/v1/assets/{record}/todos/{todo} -
DELETE
Delete an asset to-do
/api/v1/assets/{record}/todos/{todo} -
POST
Add an asset note
/api/v1/assets/{record}/notes -
POST
Add an asset event
/api/v1/assets/{record}/events -
GET
Asset event options
/api/v1/assets/{record}/events/options -
PUT
Assign an asset to a person
/api/v1/assets/{record}/assignments/person -
GET
Asset person assignment options
/api/v1/assets/{record}/assignments/person/options -
DELETE
Remove asset person assignment
/api/v1/assets/{record}/assignments/person -
PUT
Assign an asset to a location
/api/v1/assets/{record}/assignments/location -
GET
Asset location assignment options
/api/v1/assets/{record}/assignments/location/options -
DELETE
Remove asset location assignment
/api/v1/assets/{record}/assignments/location -
PUT
Put an asset in storage
/api/v1/assets/{record}/assignments/storage -
GET
Asset storage assignment options
/api/v1/assets/{record}/assignments/storage/options -
DELETE
Remove asset storage assignment
/api/v1/assets/{record}/assignments/storage -
PUT
Set an asset’s subscriptions
/api/v1/assets/{record}/assignments/subscriptions -
GET
Asset subscriptions assignment options
/api/v1/assets/{record}/assignments/subscriptions/options -
POST
Record an asset acquisition
/api/v1/assets/{record}/acquisitions -
GET
Asset acquisition options
/api/v1/assets/{record}/acquisitions/options -
POST
Add an asset warranty
/api/v1/assets/{record}/warranties -
PUT
Set an asset condition
/api/v1/assets/{record}/condition -
GET
Asset condition options
/api/v1/assets/{record}/condition/options -
POST
Decommission an asset
/api/v1/assets/{record}/decommission -
GET
Asset decommission options
/api/v1/assets/{record}/decommission/options -
POST
Restore a decommissioned asset
/api/v1/assets/{record}/restore
People
-
GET
List people
/api/v1/people -
GET
Get a person
/api/v1/people/{record} -
GET
Person creation options
/api/v1/people/options -
POST
Create a person
/api/v1/people -
PATCH / PUT
Update a person
/api/v1/people/{record} -
POST / DELETE
Manage a person image
/api/v1/people/{record}/image -
DELETE
Delete a person
/api/v1/people/{record} -
GET
People timeline
/api/v1/people/{record}/timeline -
GET
Get a person timeline entry
/api/v1/people/{record}/timeline/{type}/{entry} -
GET
Person timeline lookup options
/api/v1/people/{record}/timeline/{type}/{entry}/options -
POST
Manage person timeline comments
/api/v1/people/{record}/timeline/{type}/{entry}/comments -
PATCH
Update a person timeline entry
/api/v1/people/{record}/timeline/{type}/{entry} -
DELETE
Delete a person timeline entry
/api/v1/people/{record}/timeline/{type}/{entry}
People actions
-
POST
Create a person to-do
/api/v1/people/{record}/todos -
GET
List person to-dos
/api/v1/people/{record}/todos -
GET
Person to-do assignees
/api/v1/people/{record}/todos/options -
PATCH
Update a person to-do
/api/v1/people/{record}/todos/{todo} -
DELETE
Delete a person to-do
/api/v1/people/{record}/todos/{todo} -
POST
Add a person note
/api/v1/people/{record}/notes -
POST
Log a person event
/api/v1/people/{record}/events -
GET
Person event options
/api/v1/people/{record}/events/options -
PUT
Set a person’s assets
/api/v1/people/{record}/assignments/assets -
GET
List person assets
/api/v1/people/{record}/assignments/assets -
GET
Person assets assignment options
/api/v1/people/{record}/assignments/assets/options -
PUT
Set a person’s subscriptions
/api/v1/people/{record}/assignments/subscriptions -
GET
List person subscriptions
/api/v1/people/{record}/assignments/subscriptions -
GET
Person subscriptions assignment options
/api/v1/people/{record}/assignments/subscriptions/options -
PUT
Set a person’s locations
/api/v1/people/{record}/assignments/locations -
GET
List person locations
/api/v1/people/{record}/assignments/locations -
GET
Person locations assignment options
/api/v1/people/{record}/assignments/locations/options -
PUT
Set person status
/api/v1/people/{record}/status -
GET
Person status options
/api/v1/people/{record}/status/options
Locations
-
GET
List locations
/api/v1/locations -
GET
Get a location
/api/v1/locations/{record} -
GET
Location creation options
/api/v1/locations/options -
POST
Create a location
/api/v1/locations -
PATCH / PUT
Update a location
/api/v1/locations/{record} -
POST / DELETE
Manage a location image
/api/v1/locations/{record}/image -
DELETE
Delete a location
/api/v1/locations/{record} -
GET
Locations timeline
/api/v1/locations/{record}/timeline -
GET
Get a location timeline entry
/api/v1/locations/{record}/timeline/{type}/{entry} -
GET
Location timeline lookup options
/api/v1/locations/{record}/timeline/{type}/{entry}/options -
POST
Manage location timeline comments
/api/v1/locations/{record}/timeline/{type}/{entry}/comments -
PATCH
Update a location timeline entry
/api/v1/locations/{record}/timeline/{type}/{entry} -
DELETE
Delete a location timeline entry
/api/v1/locations/{record}/timeline/{type}/{entry}
Location actions
-
POST
Create a location to-do
/api/v1/locations/{record}/todos -
GET
List location to-dos
/api/v1/locations/{record}/todos -
GET
Location to-do assignees
/api/v1/locations/{record}/todos/options -
PATCH
Update a location to-do
/api/v1/locations/{record}/todos/{todo} -
DELETE
Delete a location to-do
/api/v1/locations/{record}/todos/{todo} -
POST
Add a location note
/api/v1/locations/{record}/notes -
POST
Log a location event
/api/v1/locations/{record}/events -
GET
Location event options
/api/v1/locations/{record}/events/options -
PUT
Set a location’s assets
/api/v1/locations/{record}/assignments/assets -
GET
List location assets
/api/v1/locations/{record}/assignments/assets -
GET
Location assets assignment options
/api/v1/locations/{record}/assignments/assets/options -
PUT
Set a location’s subscriptions
/api/v1/locations/{record}/assignments/subscriptions -
GET
List location subscriptions
/api/v1/locations/{record}/assignments/subscriptions -
GET
Location subscriptions assignment options
/api/v1/locations/{record}/assignments/subscriptions/options -
PUT
Set a location’s people
/api/v1/locations/{record}/assignments/people -
GET
List location people
/api/v1/locations/{record}/assignments/people -
GET
Location people assignment options
/api/v1/locations/{record}/assignments/people/options -
PUT
Set location status
/api/v1/locations/{record}/status -
GET
Location status options
/api/v1/locations/{record}/status/options -
POST
Create a location space
/api/v1/locations/{record}/spaces -
GET
List location spaces
/api/v1/locations/{record}/spaces -
PATCH
Update a location space
/api/v1/locations/{record}/spaces/{space} -
DELETE
Delete a location space
/api/v1/locations/{record}/spaces/{space}
Subscriptions
-
GET
List subscriptions
/api/v1/subscriptions -
GET
Get a subscription
/api/v1/subscriptions/{record} -
GET
Subscription creation options
/api/v1/subscriptions/options -
POST
Create a subscription
/api/v1/subscriptions -
PATCH / PUT
Update a subscription
/api/v1/subscriptions/{record} -
DELETE
Delete a subscription
/api/v1/subscriptions/{record} -
GET
Subscriptions timeline
/api/v1/subscriptions/{record}/timeline -
GET
Get a subscription timeline entry
/api/v1/subscriptions/{record}/timeline/{type}/{entry} -
GET
Subscription timeline lookup options
/api/v1/subscriptions/{record}/timeline/{type}/{entry}/options -
POST
Manage subscription timeline comments
/api/v1/subscriptions/{record}/timeline/{type}/{entry}/comments -
PATCH
Update a subscription timeline entry
/api/v1/subscriptions/{record}/timeline/{type}/{entry} -
DELETE
Delete a subscription timeline entry
/api/v1/subscriptions/{record}/timeline/{type}/{entry}
Subscription actions
-
POST
Create a subscription to-do
/api/v1/subscriptions/{record}/todos -
GET
List subscription to-dos
/api/v1/subscriptions/{record}/todos -
GET
Subscription to-do assignees
/api/v1/subscriptions/{record}/todos/options -
PATCH
Update a subscription to-do
/api/v1/subscriptions/{record}/todos/{todo} -
DELETE
Delete a subscription to-do
/api/v1/subscriptions/{record}/todos/{todo} -
POST
Add a subscription note
/api/v1/subscriptions/{record}/notes -
PUT
Set a subscription’s assets
/api/v1/subscriptions/{record}/assignments/assets -
GET
List subscription assets
/api/v1/subscriptions/{record}/assignments/assets -
GET
Subscription assets assignment options
/api/v1/subscriptions/{record}/assignments/assets/options -
PUT
Set a subscription’s people
/api/v1/subscriptions/{record}/assignments/people -
GET
List subscription people
/api/v1/subscriptions/{record}/assignments/people -
GET
Subscription people assignment options
/api/v1/subscriptions/{record}/assignments/people/options -
PUT
Set a subscription’s locations
/api/v1/subscriptions/{record}/assignments/locations -
GET
List subscription locations
/api/v1/subscriptions/{record}/assignments/locations -
GET
Subscription locations assignment options
/api/v1/subscriptions/{record}/assignments/locations/options -
PUT
Update subscription billing
/api/v1/subscriptions/{record}/billing -
GET
Subscription billing options
/api/v1/subscriptions/{record}/billing/options -
POST
Add a subscription contract
/api/v1/subscriptions/{record}/contracts -
GET
Subscription contract options
/api/v1/subscriptions/{record}/contracts/options -
POST
Pause a subscription
/api/v1/subscriptions/{record}/pause -
GET
Subscription pause options
/api/v1/subscriptions/{record}/pause/options -
POST
Resume a subscription
/api/v1/subscriptions/{record}/resume -
POST
Cancel a subscription
/api/v1/subscriptions/{record}/cancel -
POST
Retire a subscription
/api/v1/subscriptions/{record}/retire -
POST
Restore a subscription
/api/v1/subscriptions/{record}/restore
Search and to-dos
GPS tracking
Dashboard reports
-
Dashboard reports
Read the same summaries, charts, and lists as the AssetCenter dashboard through the public API.
-
GET
Get the dashboard summary
/api/v1/dashboard -
GET
Get dashboard status counts
/api/v1/dashboard/top-cards -
GET
Get the deployed assets chart
/api/v1/dashboard/deployed-assets-chart -
GET
List assets reaching end of life
/api/v1/dashboard/assets-eol -
GET
List expiring warranties
/api/v1/dashboard/expiring-warranties -
GET
List expiring contracts
/api/v1/dashboard/expiring-contracts -
GET
Get subscription cost by month
/api/v1/dashboard/subscription-cost -
GET
List recent activity
/api/v1/dashboard/recent-activity -
GET
List tracked assets on the map
/api/v1/dashboard/gps-assets