AMCS Group Asset API
The Asset API from AMCS Group — 1 operation(s) for asset.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/amcs-group:amcs-group-asset-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Amcs Group Asset API
version: external
description: 'Operations tagged Asset across 2 of this provider''s published API definitions: amcs-group-openapi.json, amcs-group-visionai-openapi-original.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://eu1-tracker-dev-app.azurewebsites.net
description: Direct Access
- url: https://o1-dev-svc-core.amcsplatform.com/
description: AMCS VisionAI Developer Environment
tags:
- name: Asset
paths:
/integrator/assets/changes:
get:
tags:
- Asset
summary: Request list of Asset changes
description: '# Request list of Asset changes
Retrieve the assets (vehicles) of the calling tenant that have been created, updated or deleted since a specific point in the history.
## Notes
- Call without `since` to get the full list. Follow `links.next` while it is present, then store `extra.until` and send it as `since` on the next poll.
- Deleted assets are returned with `IsDeleted: true`.'
parameters:
- name: since
in: query
description: Bookmark from extra.until
style: form
schema:
type: string
- name: cursor
in: query
description: Bookmark from extra.cursor
style: form
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResourceChanges_ApiAssetResource'
operationId: getIntegratorAssetsChanges
x-operation-id-source: derived
servers:
- url: https://eu1-tracker-dev-app.azurewebsites.net
description: Direct Access
/integrator/assets:
post:
tags:
- Asset
summary: Create or Update an Asset (Vehicle)
description: '# Create or Update an Asset (Vehicle)'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ApiAssetResource'
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
properties:
errors:
$ref: '#/components/schemas/ApiResourceErrors'
status:
$ref: '#/components/schemas/ApiResourceStatus'
resource:
type: string
description: GUID of the created or updated asset.
format: uuid
additionalProperties: false
description: Identifier of the created or updated resource.
operationId: postIntegratorAssets
x-operation-id-source: derived
servers:
- url: https://eu1-tracker-dev-app.azurewebsites.net
description: Direct Access
/visionai/api/integrator/assets:
post:
tags:
- Asset
summary: Create or Update an Asset (Vehicle)
description: '# Create or Update an Asset (Vehicle)
| Parameter | Type | Description |
|--------------|--------|-----------------------------------------------------------------|
| AssetId | GUID | ID of the Asset |
| AssetName | string | Display name (vehicle registration plate) |
| AssetType | string | Front Loader, Side Loader, Rear End Loader |
| OutletId | GUID | ID of the Company Outlet associated with the Asset |
| CompanyCode | string | Company code associated with the Asset |
| IsDeleted | bool | Asset is no longer in use |
## Sample API Requests
```
{
"AssetId": "B3E43C4D-BC76-4E59-9E2E-25BC33EA2EC4",
"AssetName": "VEH 001",
"AssetType": "Front Loader",
"OutletId": "2FAD788D-A748-4520-9120-923DA1E42942",
"CompanyCode": "Trux Company 1",
"IsDeleted": false
}
```
## Sample API Response
```
{
"resource" : "B3E43C4D-BC76-4E59-9E2E-25BC33EA2EC4"
}'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/AMCS.IoT.Contamination.Api.Integrator.Asset.ApiAsset'
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResourceId'
'400':
$ref: '#/components/responses/BadRequest'
'401':
description: Unauthorized
'403':
$ref: '#/components/responses/Forbidden'
'404':
$ref: '#/components/responses/NotFound'
'500':
description: Internal Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/ApiauthTokens500Error'
'501':
$ref: '#/components/responses/NotImplemented'
'502':
$ref: '#/components/responses/BadGateway'
'503':
$ref: '#/components/responses/ServiceUnavailable'
'504':
$ref: '#/components/responses/GatewayTimeout'
security:
- cookieAuth: []
operationId: postVisionaiApiIntegratorAssets
x-operation-id-source: derived
servers:
- url: https://o1-dev-svc-core.amcsplatform.com/
description: AMCS VisionAI Developer Environment
components:
schemas:
ApiResourceResultUpdatesExtra:
type: object
properties:
until:
type:
- string
- 'null'
description: Bookmark to put in as "since" later - appears when there are no more pages for now
cursor:
type:
- string
- 'null'
additionalProperties: false
ApiResourceResultChangesLinks:
type: object
properties:
next:
type:
- string
- 'null'
description: Link to follow to get next page with changes
additionalProperties: false
ApiAssetResource:
type: object
properties:
GUID:
type:
- string
- 'null'
format: uuid
AssetId:
type:
- string
- 'null'
description: ID of the Asset
format: uuid
AssetExternalId:
type:
- integer
- 'null'
description: External System Identifier for Asset (optional)
format: int32
AssetName:
type:
- string
- 'null'
description: Display name (vehicle registration plate)
AssetType:
type:
- string
- 'null'
description: Front Loader, Side Loader, Rear End Loader
OutletId:
type:
- string
- 'null'
description: ID of the Company Outlet associated with the Asset
format: uuid
OutletName:
type:
- string
- 'null'
description: Name of the Outlet (optional)
CompanyCode:
type:
- string
- 'null'
description: Company code associated with the Asset
IsDeleted:
type: boolean
description: Asset is no longer in use
RegistrationNo:
type:
- string
- 'null'
description: Vehicle registration number. Saved exactly as sent on every create or update call.
VehicleCode:
type:
- string
- 'null'
description: Vehicle code used by the integrator's system. Saved exactly as sent on every create or update call.
VIN:
type:
- string
- 'null'
description: Vehicle Identification Number of the asset. Optional.
TenantId:
type:
- integer
- 'null'
description: Internal. Filled from the calling tenant when omitted; integrators do not need to send it.
format: int32
additionalProperties: false
ApiResourceChanges_ApiAssetResource:
type: object
properties:
errors:
$ref: '#/components/schemas/ApiResourceErrors'
status:
$ref: '#/components/schemas/ApiResourceStatus'
resource:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/ApiAssetResource'
links:
$ref: '#/components/schemas/ApiResourceResultChangesLinks'
extra:
$ref: '#/components/schemas/ApiResourceResultUpdatesExtra'
additionalProperties: false
ApiResourceStatus:
type: object
properties:
id:
type:
- integer
- 'null'
description: Internal numeric identifier of the affected record, or null when it is not applicable.
format: int32
isSuccess:
type: boolean
description: True when the operation completed successfully; otherwise false.
additionalProperties: false
description: Outcome of the create or update operation.
ApiResourceErrors:
type: object
properties:
errors:
type:
- string
- 'null'
description: Error details describing why the request was rejected, or null when there were no errors.
additionalProperties: false
description: Validation and processing errors for the request. Populated only when the operation fails.
AMCS.IoT.Contamination.Api.Integrator.Asset.ApiAsset:
type: object
properties:
assetId:
type:
- string
- 'null'
format: uuid
assetName:
type:
- string
- 'null'
assetType:
type:
- string
- 'null'
outletId:
type:
- string
- 'null'
format: uuid
companyCode:
type:
- string
- 'null'
isDeleted:
type: boolean
additionalProperties: false
ApiauthTokens500Error:
type: object
properties:
message:
type:
- string
- 'null'
type:
type:
- string
- 'null'
stackTrace:
type:
- string
- 'null'
additionalProperties: false
ApiResourceId:
type: object
properties:
errors:
$ref: '#/components/schemas/ApiResourceErrors_2'
status:
$ref: '#/components/schemas/ApiResourceStatus_2'
resource:
type: guid
additionalProperties: false
ApiResourceStatus_2:
type: object
properties:
id:
type:
- integer
- 'null'
format: int32
isSuccess:
type: boolean
additionalProperties: false
ApiResourceErrors_2:
type: object
properties:
errors:
type:
- string
- 'null'
additionalProperties: false
responses:
BadGateway:
description: Bad Gateway - The upstream server returned an invalid response.
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: Temporary issue with the server. Please try again later.
additionalProperties: false
BadRequest:
description: Bad Request - Invalid input parameters.
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: Invalid request. Please check your input parameters.
additionalProperties: false
NotFound:
description: Not Found - The requested resource was not found.
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: The requested resource was not found.
additionalProperties: false
Forbidden:
description: Forbidden - Access denied.
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: You do not have permission to access this resource.
additionalProperties: false
GatewayTimeout:
description: Gateway Timeout - The server took too long to respond.
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: The request timed out. Please try again later.
additionalProperties: false
ServiceUnavailable:
description: Service Unavailable - The server is currently unavailable.
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: Service is currently unavailable. Please try again later.
additionalProperties: false
NotImplemented:
description: This feature is not implemented.
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: This feature is not implemented.
additionalProperties: false
x-refined-from:
- amcs-group-openapi.json
- amcs-group-visionai-openapi-original.json