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 · 117 endpoint pages
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 requests without duplicating successful actions or timeline events.
-
Errors and rate limits
Interpret API errors, respect request limits, and resolve workflow conflicts.
Assets
-
GET
List assets
/api/v1/assets -
GET
Get an asset
/api/v1/assets/{record} -
GET
Asset creation options
/api/v1/assets/options -
POST
Create an asset
/api/v1/assets -
PATCH / PUT
Update an asset
/api/v1/assets/{record} -
DELETE
Delete an asset
/api/v1/assets/{record} -
GET
Assets timeline
/api/v1/assets/{record}/timeline
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
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} -
DELETE
Delete a person
/api/v1/people/{record} -
GET
People timeline
/api/v1/people/{record}/timeline
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 -
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} -
DELETE
Delete a location
/api/v1/locations/{record} -
GET
Locations timeline
/api/v1/locations/{record}/timeline
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 -
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
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