Sign in

v1

latestOpenAPI 3.1.02026-07-264793109.1 KB
4. Assets

Event Handling Status Update

Provide an update on the handling of a given event by a given asset.

This endpoint allows asset controllers to report back the status of event handling. The asset_id can be either the Axle UUID or an external ID if asset_id_is_external is true.

Note: This will not work for non-UUID external asset IDs.

post/entities/asset/{asset_id}/callback/{event_id}

Path parameters

asset_idstring uuid required
event_idstring required

Query parameters

asset_id_is_externalboolean

Request body

timestampstring date-time required

Timestamp for the response (UTC)

status'RECEIVED' | 'ACCEPTED' | 'REJECTED' | 'FAILED' | 'EXECUTED' required

Status values for asset event handling.

  • RECEIVED: Event was received by the system
  • ACCEPTED: Event was accepted for processing
  • REJECTED: Event was rejected (invalid or not applicable)
  • FAILED: Event processing failed
  • EXECUTED: Event was successfully executed

Response

Status update successfully recorded

{"stackTrail":"paths:/entities/asset/{asset_id}/callback/{event_id}:post:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}