Hiboo Connect

The following endpoints allow you to share your equipment data with other organizations, and manage the sharing process.

List Sharing

get
/v2/fleet/sharings

Returns all Sharing instances that have been created

Authorizations
x-access-tokenstringRequired

Generate a JWT when you log in. Use it in your following requests in the header as x-access-token: your-token-here

Query parameters
offsetintegerRequired

The number of items to skip before starting to collect the result set

limitintegerRequired

The number of items to return

Responses
200

successful operation

application/json
get
/v2/fleet/sharings

Create a new Sharing

post
/v2/fleet/sharings

This endpoint will allow you to create a new instance of Sharing. It can be a contract for instance.

Authorizations
x-access-tokenstringRequired

Generate a JWT when you log in. Use it in your following requests in the header as x-access-token: your-token-here

Body
referencestringRequired

It can be a contract reference for instance

Example: contract-4242-2024
startDatestring · date-timeRequired

Date from which the sharing of data should start serialized as an ISO8601 string with a timezone (YYYY-MM-DDTHH:mm:ssZ). The date must not be before one rolling year.

endDatestring · date-timeRequired

Date when the sharing of data should stop serialized as an ISO8601 string with a timezone (YYYY-MM-DDTHH:mm:ssZ). Equipment data will be shared as long as it is empty, set it to null if the end date is unsure

assetIdsnumber · int64[] · min: 1Required

All the equipment that you wish to share, use Hiboo's ids

Example: 1
recipientstring · emailRequired

Recipient's email address

Example: [email protected]
notificationEnabledbooleanOptional

If false, the recipient will not be notified when the sharing is created or started

Responses
post
/v2/fleet/sharings

Delete a Sharing

delete
/v2/fleet/sharings/{reference}

It totally deletes a Sharing as it never existed.

Authorizations
x-access-tokenstringRequired

Generate a JWT when you log in. Use it in your following requests in the header as x-access-token: your-token-here

Path parameters
referencestringRequired

The reference you defined when creating the Sharing

Example: contract-4242-2024
Responses
delete
/v2/fleet/sharings/{reference}

No content

Update an existing sharing

patch
/v2/fleet/sharings/{reference}

Update an existing sharing by reference

Authorizations
x-access-tokenstringRequired

Generate a JWT when you log in. Use it in your following requests in the header as x-access-token: your-token-here

Path parameters
referencestringRequired

The reference you defined when creating the Sharing

Example: contract-4242-2024
Body
referencestringOptional

It can be a contract reference for instance

Example: contract-4242-2024
startDatestring · date-timeOptional

Date from which the sharing of data should start serialized as an ISO8601 string with a timezone (YYYY-MM-DDTHH:mm:ssZ). The date must not be before one rolling year.

endDatestring · date-timeOptional

Date when the sharing of data should stop serialized as an ISO8601 string with a timezone (YYYY-MM-DDTHH:mm:ssZ). Equipment data will be shared as long as it is empty, so you can set it to null if the end date is unsure

Responses
200

Successful operation

application/json
patch
/v2/fleet/sharings/{reference}

Stop the sharing

delete
/v2/fleet/sharings/{reference}/in-progress

This endpoint will stop the sharing of data for the specified reference. It will not delete the sharing, but it will stop the data sharing process.

Authorizations
x-access-tokenstringRequired

Generate a JWT when you log in. Use it in your following requests in the header as x-access-token: your-token-here

Path parameters
referencestringRequired

The reference you defined when creating the Sharing

Example: contract-4242-2024
Responses
delete
/v2/fleet/sharings/{reference}/in-progress

No content

Last updated

Was this helpful?