# Perspio Documentation > Perspio Developer Hub Append .md to any documentation page URL to get its markdown version. ## Guides - [Key Concepts](https://developers.perspio.io/docs/key-concepts.md): The building blocks Perspio uses to model your operation. - [Security & Resilience](https://developers.perspio.io/docs/security-and-resilience.md): How Perspio keeps your data secure, isolated and available. - [Mobile App](https://developers.perspio.io/docs/mobile-app.md): Perspio on iOS and Android, for teams in the field. - [Power BI Custom Connector](https://developers.perspio.io/docs/power-bi-custom-connector.md): This article lists the steps to host and consume the Power BI Custom Connector for Perspio. - [Webhook Connectors](https://developers.perspio.io/docs/webhook-connectors.md): Changes sent to Perspio from other systems as they happen. - [Action Connectors](https://developers.perspio.io/docs/action-connectors.md): What workflows can do when their conditions are met. ## API Reference - [Get Access Token](https://developers.perspio.io/reference/get-access-token.md): Exchange your API application's client ID and secret for a bearer token, then use it to call any PerspioTalk API. - [Pagination](https://developers.perspio.io/reference/pagination.md): Page through long lists with page_size and a continuation token. - [Get Assets](https://developers.perspio.io/reference/getassets-2.md): Fetch all assets. Operates on assets in the current tenant. - [Get Asset](https://developers.perspio.io/reference/getasset.md): Fetch detailed information about an asset. - [Create Asset](https://developers.perspio.io/reference/createasset-1.md): Create a new asset. Operates on asset in the current tenant. - [Update Asset](https://developers.perspio.io/reference/updateasset-1.md): Update an asset. Operates on asset in the current tenant. - [Patch Asset](https://developers.perspio.io/reference/patchasset-1.md): Update specific fields of an asset. - [Delete Asset](https://developers.perspio.io/reference/deleteasset.md): Delete an asset by id. Operates on asset in the current tenant. - [Archive Asset](https://developers.perspio.io/reference/archiveasset.md): Archive an asset, removing it from active views. - [Enable Asset](https://developers.perspio.io/reference/enableasset.md): Enable (re-activate) a previously disabled asset. - [Get Assets Info](https://developers.perspio.io/reference/getassetsinfo-1.md): Fetch assets info. Operates on assets info in the current tenant. - [Get Asset Info](https://developers.perspio.io/reference/getassetinfo-1.md): Fetch the master data of an asset. - [Update Asset Info](https://developers.perspio.io/reference/updateassetinfo.md): Update master data of an asset. - [Get Asset Schema](https://developers.perspio.io/reference/getassetschema.md): Fetch the schema of an asset. - [Get Asset Master Schema](https://developers.perspio.io/reference/getassetmasterschema-1.md): Retrieve the asset master schema definition for a tenant. - [Update Asset Master Schema](https://developers.perspio.io/reference/updateassetmasterschema.md): Update the asset master schema for a tenant. - [Export Tenant Asset Master Schema](https://developers.perspio.io/reference/exporttenantassetmasterschema.md): Export the tenant-specific asset master schema overrides. Returns only properties that differ from the global schema, with all sub-properties fully populated (e.g., flags and position include all fields merged from global). - [Import Tenant Asset Master Schema](https://developers.perspio.io/reference/importtenantassetmasterschema.md): Import tenant-specific asset master schema overrides. Only metadata.* properties that exist in the global schema are accepted. Properties are merged field-by-field with the global schema (unspecified fields preserve global values). The dataType and unitType fields cannot be overridden. - [Get Asset Types](https://developers.perspio.io/reference/getassettypes.md): Fetch asset types. Operates on asset types in the current tenant. - [Get Asset Type](https://developers.perspio.io/reference/getassettype.md): Fetch type of an asset. Operates on asset type in the current tenant. - [Create Asset Type](https://developers.perspio.io/reference/createassettype.md): Create Asset Type. Operates on asset type in the current tenant. - [Update Asset Type](https://developers.perspio.io/reference/updateassettype.md): Update Asset Type. Operates on asset type in the current tenant. - [Delete Asset Type](https://developers.perspio.io/reference/deleteassettype.md): Delete Asset Type. Operates on asset type in the current tenant. - [Get Asset Metrics](https://developers.perspio.io/reference/getassetmetrics.md): Fetch telemetry data of an asset. - [Get Asset Metrics Summary](https://developers.perspio.io/reference/getassetmetricssummary.md): Fetch metrics summary of an asset. - [Get Asset Metrics Count](https://developers.perspio.io/reference/getassetmetricscount-1.md): Fetch the history update count of an asset. - [Get Asset History](https://developers.perspio.io/reference/getobjecthistory-1.md): Fetch historical data of an asset. - [Fetch and explore system object data](https://developers.perspio.io/reference/getsystemobjectdata.md): Fetch system object data for assets, devices, events, etc. Supports filtering, field selection, and pagination. - [Get Asset Latency Data](https://developers.perspio.io/reference/getassetslatencydata-1.md): Fetch latency data of an asset. - [Get Asset Custom Counters](https://developers.perspio.io/reference/getassetcustomcounters.md): Fetch custom counters of an asset. - [Update Custom Counters](https://developers.perspio.io/reference/updatecustomcounters.md): Update custom counters for a specific asset. - [Update Asset Meters](https://developers.perspio.io/reference/calibrateasset-1.md): Update the meters (e.g., odometer or run hours) of an asset. - [Get Asset Anomalies](https://developers.perspio.io/reference/getassetdataanomalies-1.md): Fetch anomaly detection analysis of an asset. - [Get Asset Forecast](https://developers.perspio.io/reference/getassetdataforecast-1.md): Fetch forecasting analysis of an asset. - [Get Asset Events](https://developers.perspio.io/reference/getassetevents-1.md): Fetch event logs of an asset. The continuation token may alternatively be sent as the raw request body - useful when the token is too long for the query string or header; the body is only read when neither the token query parameter nor the ContinuationToken header is set. - [Get Asset Recent Events](https://developers.perspio.io/reference/getassetrecentevents.md): Fetch recent events of an asset. - [Get Asset Events Master](https://developers.perspio.io/reference/getasseteventsmaster.md): Retrieve events master data - [Bulk Update Asset Events Master](https://developers.perspio.io/reference/bulkupdateeventsmasterdata-1.md): Create bulk update events masterdata. - [Update Asset Events Master](https://developers.perspio.io/reference/updatasseteventsmaster.md): Update updat asset events master. - [Get Asset Utilisation Average](https://developers.perspio.io/reference/getutilisationaverage.md): Fetch utilisation average of an asset. - [Get Asset Utilisation Summary](https://developers.perspio.io/reference/getutilisationsummary.md): Fetch utilisation summary of an asset. - [Gets Asset Meters Utilisation](https://developers.perspio.io/reference/getmetersutilisation.md): Fetch meter utilisation report of an asset. - [Gets Asset Uptime Overview](https://developers.perspio.io/reference/getassetuptimeoverview.md): Per-day asset uptime bucket counts (isHealthy / silent / unhealthy / noDevice) from the nightly uptime snapshot. Days are opaque UTC date keys (yyyy-MM-dd), each covering the completed UTC day window [D 00:00, D+1 00:00). The snapshot is day-behind: the latest available day is yesterday UTC. Defaults: to = yesterday UTC, from = to - 29 days; maximum range 366 days. Hierarchy global filters match the values stamped on each snapshot day (historical semantics). - [Gets Asset Uptime Details for a Day](https://developers.perspio.io/reference/getassetuptimedetails.md): Paged per-asset uptime rows for a single UTC day from the nightly uptime snapshot, ordered worst first (unhealthy, silent, healthy, none; largest communication gap first). The date is required and only one day can be queried per request. Master-data fields (name, serial, hierarchy) are stamped as-of the snapshot run. - [Get Asset Trips](https://developers.perspio.io/reference/gettrips.md): Fetch trips of an asset. Operates on trips in the current tenant. - [Get Latest Asset Trips](https://developers.perspio.io/reference/getlatestassettrips.md): Fetch recent trips of an asset. - [Get Asset Trips](https://developers.perspio.io/reference/getassettrips-1.md): Fetch trips of an asset (utilisation perspective). - [Get Asset Groups](https://developers.perspio.io/reference/getassetgroups.md): Retrieve groups an asset is a member of. - [Update Asset Groups](https://developers.perspio.io/reference/updateassetgroups.md): Update asset groups. Operates on asset groups in the current tenant. - [Get Asset Relationships](https://developers.perspio.io/reference/getassetrelationships-1.md): Fetch relationships of an asset. - [Get Asset Tenant Hierarchies](https://developers.perspio.io/reference/getassettenanthierarchies.md): Fetch asset tenant hierarchies. - [Get Asset Dependencies](https://developers.perspio.io/reference/checkobjectdependency-1.md): Fetch dependencies of an asset. - [Get Asset Property Dependencies](https://developers.perspio.io/reference/checksignaldependency.md): Fetch dependencies of an asset property. - [Get Asset Share Configs](https://developers.perspio.io/reference/getshareconfigsforasset.md): Fetch share configs of an asset. - [Get Asset Share Config](https://developers.perspio.io/reference/getassetshareconfig.md): Fetch share config of an asset. - [Get Assets Share Config](https://developers.perspio.io/reference/getassetsshareconfig.md): Fetch share configurations of an asset. - [Create Asset Share Config](https://developers.perspio.io/reference/createassetshareconfig.md): Create share config for an asset. - [Update Asset Share Config](https://developers.perspio.io/reference/updateassetshareconfig.md): Update share config of an asset. - [Delete Asset Share Config](https://developers.perspio.io/reference/deleteshareconfigforasset.md): Delete a share config of an asset. - [Get Asset Work Hour Profile](https://developers.perspio.io/reference/getassetworkhourprofile.md): Fetch working hours profile of an asset. - [Update Asset Work Hour Profile](https://developers.perspio.io/reference/updateassetworkhourprofile.md): Update working hours profile of an asset. - [Create Asset Share Link](https://developers.perspio.io/reference/shareasset.md): Create a public URL to share an asset. - [Create Asset Share](https://developers.perspio.io/reference/createassetshare.md): Create an asset share. Operates on asset share in the current tenant. - [Get Asset Share Tokens](https://developers.perspio.io/reference/getassetsharetokens.md): List asset share tokens. Operates on asset share tokens in the current tenant. - [Update Asset Share Token](https://developers.perspio.io/reference/updateassetsharetoken.md): Update share token of an asset. - [Get Asset Documents](https://developers.perspio.io/reference/getassetdocuments.md): Fetch documents of an asset. - [Upload Asset Document](https://developers.perspio.io/reference/uploadassetdocument.md): Create a document for an asset. - [Update Asset Document Metadata](https://developers.perspio.io/reference/updateassetdocumentmetadata.md): Update document metadata of an asset. - [Delete Asset Document](https://developers.perspio.io/reference/deleteassetdocument.md): Delete a document of an asset. - [Get Asset Images](https://developers.perspio.io/reference/getimages.md): Fetch images of an asset. - [Upload Asset Image](https://developers.perspio.io/reference/uploadassetimage.md): Create an image for an asset. - [Update Asset Image Metadata](https://developers.perspio.io/reference/updateassetimagemetadata.md): Update asset image metadata. - [Delete Asset Image](https://developers.perspio.io/reference/deleteimages-1.md): Delete images of an asset. - [Get Asset Links](https://developers.perspio.io/reference/getdocumentlinks.md): Fetch all document links for an asset. - [Upload Asset Document Link](https://developers.perspio.io/reference/uploadassetdocumentlink.md): Create a document link for an asset. - [Update Asset Document Link](https://developers.perspio.io/reference/updateassetdocumentlink.md): Update a document link of an asset. - [Delete Asset Document Links](https://developers.perspio.io/reference/deletedocumentlinks.md): Delete document links for an Asset. - [Get Asset Comments](https://developers.perspio.io/reference/getcomments.md): Retrieve comments of an asset. - [Add Asset Comment](https://developers.perspio.io/reference/addassetcomment.md): Add a comment to an asset. - [Get All References](https://developers.perspio.io/reference/getallreferences.md): Fetch all document library references. - [Get Reference](https://developers.perspio.io/reference/getreference.md): Fetch a document library reference by ID. - [Create Reference](https://developers.perspio.io/reference/createreference.md): Create a new document library reference. - [Update Reference](https://developers.perspio.io/reference/updatereference.md): Update an existing document library reference. - [Delete Reference](https://developers.perspio.io/reference/deletereference.md): Delete a document library reference and all its associated documents, images, and links. - [Get Reference Images](https://developers.perspio.io/reference/getreferenceimages.md): Fetch images for a document library reference. - [Upload Reference Image](https://developers.perspio.io/reference/uploadreferenceimage.md): Upload an image for a document library reference. - [Update Reference Image Metadata](https://developers.perspio.io/reference/updatereferenceimagemetadata.md): Update image metadata for a document library reference. - [Delete Reference Images](https://developers.perspio.io/reference/deletereferenceimages.md): Delete one or more images for a document library reference. - [Get Reference Documents](https://developers.perspio.io/reference/getreferencedocuments.md): Fetch documents for a document library reference. - [Upload Reference Document](https://developers.perspio.io/reference/uploadreferencedocument.md): Upload a document for a document library reference. - [Update Reference Document Metadata](https://developers.perspio.io/reference/updatereferencedocumentmetadata.md): Update document metadata for a document library reference. - [Delete Reference Document](https://developers.perspio.io/reference/deletereferencedocuments.md): Delete a document for a document library reference. - [Get Reference Links](https://developers.perspio.io/reference/getreferencelinks.md): Fetch links for a document library reference. - [Upload Reference Link](https://developers.perspio.io/reference/uploadreferencelink.md): Create a document link for a document library reference. - [Update Reference Link](https://developers.perspio.io/reference/updatereferencelinks.md): Update a document link for a document library reference. - [Delete Reference Links](https://developers.perspio.io/reference/deletereferencelinks.md): Delete one or more document links for a document library reference. - [Get Asset Servicing Info](https://developers.perspio.io/reference/getassetmasterservicing-1.md): Fetch servicing information of an asset. - [Get Asset Service Programs](https://developers.perspio.io/reference/getassetserviceprograms.md): Fetch service programs of an asset. - [Get Asset Service Entries](https://developers.perspio.io/reference/getassetserviceentries.md): Fetch service entries of an asset. - [Get Asset Service Reminders](https://developers.perspio.io/reference/getassetservicereminders.md): Fetch service reminders of an asset. - [Get Asset Servicing History](https://developers.perspio.io/reference/getassetsservicehistory-1.md): Fetch servicing history of an asset. - [Trigger Asset Action](https://developers.perspio.io/reference/triggerassetaction.md): Trigger an enabled asset snapshot action for an asset. - [Get Asset Action History](https://developers.perspio.io/reference/getassetsactionhistory.md): Fetch directly triggered action history of an asset. - [Get Asset Workflow History](https://developers.perspio.io/reference/getassetsworkflowhistory-1.md): Fetch workflow history of an asset. - [Get Asset Rental History](https://developers.perspio.io/reference/getassetrentalhistory.md): Fetch rental history of an asset. - [Get Asset Cameras](https://developers.perspio.io/reference/getassetcameras.md): Fetch cameras of an asset. - [Get Asset Camera Snapshot](https://developers.perspio.io/reference/getassetsnapshotimage.md): Fetch snapshot image from a camera of an asset. - [Negotiate Socket Connection](https://developers.perspio.io/reference/negotiatesocketconnection.md): Negotiate a realtime telemetry socket connection. - [Negotiate Socket Connection for a specific Asset](https://developers.perspio.io/reference/negotiatesocketconnectionforasset.md): Negotiate a realtime telemetry socket connection for an asset. - [Create Asset Import Job](https://developers.perspio.io/reference/createassetimportjob.md): Submit an assets import task - [Create Asset Update Job](https://developers.perspio.io/reference/createassetupdatejob.md): Submit an asset update task - [Create Asset Provisioning Task](https://developers.perspio.io/reference/createassetprovisioningtask.md): Submit an assets provisioning task - [Get Apps](https://developers.perspio.io/reference/getappsv4.md): Fetch non-system apps provisioned through the v4 WorkOS API. Stored secrets are masked. - [Get App](https://developers.perspio.io/reference/getappv4.md): Fetch a v4 WorkOS app by its WorkOS application id. The stored secret is masked. - [Create App](https://developers.perspio.io/reference/createappv4.md): Create a WorkOS machine-to-machine app. The server generates the app name. If neither access nor the deprecated roles field is supplied, access defaults to all.read with unrestricted security-group access. The plaintext client secret is returned only in this response. - [Update App](https://developers.perspio.io/reference/updateappv4.md): Update the name and/or description of a v4 WorkOS app. Set appDescription to null to clear it. - [Delete App](https://developers.perspio.io/reference/deleteappv4.md): Delete a v4 WorkOS app. System apps cannot be deleted. - [Get App Access](https://developers.perspio.io/reference/getappaccessv4.md): Fetch an app's structured access assignment, including canonical security groups. - [Replace App Access](https://developers.perspio.io/reference/updateappaccessv4.md): Replace an app's complete access assignment. Omitted permissions or securityGroups are treated as empty collections and clear those assignments. Omitted accessProfileId defaults to api-custom. Use the canonical security-group id unrestricted for unrestricted access. - [Get App Restrictions](https://developers.perspio.io/reference/getapprestrictionsv4.md): Get the canonical security-group ids that restrict the app's data access. The value unrestricted represents unrestricted access. - [Update App Restrictions](https://developers.perspio.io/reference/updateapprestrictionsv4.md): Replace all security-group restrictions for the app while preserving its permissions and access profile. An empty array clears all security-group access. - [Get App Users](https://developers.perspio.io/reference/getappusersv4.md): Return users assigned directly to the app. WorkOS v4 apps do not expose direct user assignments, so this operation returns an empty array. - [Get App Subscription Key](https://developers.perspio.io/reference/getsubscriptionkeyv4.md): Fetch the tenant-level APIM subscription keys for the WorkOS external OAuth product. The app id is used to verify that the caller selected an existing v4 app. Because this operation exposes credentials, it requires all.readwrite or api.apps.readwrite. - [Reset App Secret](https://developers.perspio.io/reference/resetappsecretv4.md): Rotate an app's client secret. The response contains the new plaintext secret in appSecret. Store it immediately because it cannot be retrieved again. - [Get Ingress Connectors](https://developers.perspio.io/reference/getingressconnectors.md): Fetch all Ingress connectors. - [Get Ingress Connector Checkpoints](https://developers.perspio.io/reference/getingressconnectorcheckpoints.md): Fetch checkpoint of an Ingress connector. - [Get Ingress Connector History](https://developers.perspio.io/reference/getingressconnectorhistory.md): Fetch history of an Ingress connector. - [Get Data Connectors](https://developers.perspio.io/reference/getdataconnectors.md): Fetch all Data connectors. - [Get Data Connector Checkpoints](https://developers.perspio.io/reference/getdataconnectorcheckpoints.md): Fetch checkpoint of Data connector. - [Get Data Connector History](https://developers.perspio.io/reference/getdataconnectorhistory.md): Fetch history of data connector. - [Get Action Connectors](https://developers.perspio.io/reference/getactionconnectors.md): Fetch all Action Connectors. - [Get Action Schema](https://developers.perspio.io/reference/getactionschema.md): Fetch schema of an Action connector. - [Get Action Schema Template](https://developers.perspio.io/reference/getactionschematemplate.md): Fetch schema template of an Action Connector. - [Get Action Quotas](https://developers.perspio.io/reference/getactionquotas.md): Fetch quota of an Action connector. - [Get Action Connector History](https://developers.perspio.io/reference/getactionconnectorhistory.md): Fetch history of an Action connector. - [Get Safety Culture Groups](https://developers.perspio.io/reference/getsafetyculturegroups-1.md): Fetch SafetyCulture groups of Action connectors. - [Get Safety Culture Users](https://developers.perspio.io/reference/getsafetycultureusers-1.md): Fetch SafetyCulture users of Action connectors. - [Get Safety Culture Assets](https://developers.perspio.io/reference/getsafetycultureassets-1.md): Fetch SafetyCulture assets of Action connectors. - [Get Webhooks Connector](https://developers.perspio.io/reference/getwebhooksconnector.md): Fetch all Webhooks connectors. - [Get Webhook Connector History](https://developers.perspio.io/reference/getwebhookconnectorhistory.md): Fetch history of webhook connector. - [Get AI Agents](https://developers.perspio.io/reference/getaiagents.md): Fetch AI agents (catalog + tenant instances) with usage and quota overlay. - [Get AI Agent Quotas](https://developers.perspio.io/reference/getaiquotas.md): Fetch quota and usage for a tenant AI agent instance. - [Get AI Agent History](https://developers.perspio.io/reference/getaiagenthistory.md): Fetch paged run history for a tenant AI agent instance (sourced from ADX `ailogs`). - [Get Connector Configuration](https://developers.perspio.io/reference/getconnectorconfiguration.md): Fetch the configuration value of a connector. - [Update Connector Configuration](https://developers.perspio.io/reference/updateconnectorconfiguration.md): Create or update configuration of a connector. - [Enable Connector](https://developers.perspio.io/reference/enableconnector.md): Create a request to enable a connector. - [Disable Connector](https://developers.perspio.io/reference/disableconnector.md): Create a request to disable a connector. - [Get Connector Events](https://developers.perspio.io/reference/getconnectorevents.md): Fetch events of a connector. - [Negotiate Socket Connection](https://developers.perspio.io/reference/eventshubnegotiate.md): Create a negotiated socket connection. - [Get Dashboards](https://developers.perspio.io/reference/getdashboards.md): List the tenant's dashboards. - [Get Dashboard](https://developers.perspio.io/reference/getdashboard.md): Fetch a single dashboard by id. - [Create Dashboard](https://developers.perspio.io/reference/createdashboard.md): Create a new dashboard for the tenant. - [Update Dashboard](https://developers.perspio.io/reference/updatedashboard.md): Update a dashboard by id. - [Delete Dashboard](https://developers.perspio.io/reference/deletedashboard.md): Delete a dashboard by id. - [Get Dashboard Data](https://developers.perspio.io/reference/getdashboarddata.md): Return the data for a dashboard over a date range. - [Get Dashboard Assets](https://developers.perspio.io/reference/getdashboardassets.md): List the assets referenced by a dashboard. - [Get Dashboard Dictionaries](https://developers.perspio.io/reference/getdashboarddictionaries.md): Return the dictionaries (lookup metadata) for a dashboard. - [Get Dashboard Widget](https://developers.perspio.io/reference/getdashboardwidget.md): Fetch the widgets of a dashboard. - [Get Dashboard Widget Data](https://developers.perspio.io/reference/getdashboardwidgetdata.md): Return the data for a single dashboard widget over a date range. - [Get Dashboard Images](https://developers.perspio.io/reference/getdashboardimages.md): List the images of a dashboard. - [Upload Dashboard Image](https://developers.perspio.io/reference/uploaddashboardimage.md): Upload an image for a dashboard. - [Delete Dashboard Images](https://developers.perspio.io/reference/deletedashboardimages.md): Delete assocaited images from a dashboard. - [Get Devices](https://developers.perspio.io/reference/getdevices.md): List the tenant's devices. Returns a summary projection; when alldata=true the full device record is returned for each device. - [Get Device](https://developers.perspio.io/reference/getdevice.md): Fetch the current snapshot of a single device by id - its master record merged with its latest reported state. - [Get Device Info](https://developers.perspio.io/reference/getdeviceinfo.md): Fetch the descriptive information for a single device by id. - [Get Device Metadata](https://developers.perspio.io/reference/getdevicewithmetadatainfo.md): Fetch metadata and info of a device. - [Update Device](https://developers.perspio.io/reference/updatedevice.md): Apply a partial update to a single device by id. - [Get Device Types](https://developers.perspio.io/reference/getdevicetypes.md): List the available device types and their property schemas. - [Get Device Metrics](https://developers.perspio.io/reference/getdevicemetrics.md): Fetch metrics of a device. - [Get Device Updates Count](https://developers.perspio.io/reference/getdeviceupdatescount.md): Fetch update count of all devices. - [Get Device History](https://developers.perspio.io/reference/getdevicehistory.md): Fetch history data of a device. When page_size > 0 the response is paged - it returns a {key, value} envelope (key = the continuation token, value = the array of history records) plus the ContinuationToken/ResultCount/TotalCount headers; otherwise the full array is returned. - [Create Device Import Job](https://developers.perspio.io/reference/createdeviceimportjob.md): Submit a devices import task - [Create Device Bulk Update Job](https://developers.perspio.io/reference/createdevicebulkupdatejob.md): Submit a bulk device update task - [Get Geofences](https://developers.perspio.io/reference/getgeofences.md): Returns all geofences defined for the tenant as GeoJSON, filtered to those the caller is permitted to see and hydrated with the assets currently inside each one. - [Get Geofence](https://developers.perspio.io/reference/getgeofence.md): Returns a single tenant geofence by id as GeoJSON, hydrated with the assets currently inside it. Scoped to geofences the caller is permitted to see. - [Create Geofence](https://developers.perspio.io/reference/creategeofence.md): Creates a geofence for the tenant from a GeoJSON definition and returns the created geofence. Triggers a geofence re-fix so asset membership is recalculated. - [Update Geofence](https://developers.perspio.io/reference/updategeofence.md): Updates an existing tenant geofence from a GeoJSON definition. For global (all-device) geofences any existing per-group associations are cleared. Triggers a geofence re-fix. - [Delete Geofence](https://developers.perspio.io/reference/deletegeofence.md): Deletes a tenant geofence by id and triggers a geofence re-fix so asset membership is recalculated. - [Get Geofence Events](https://developers.perspio.io/reference/getgeofenceevents.md): Returns geofence entry/exit events for the geofence, within an optional time range and severity filter. When `page_size` is supplied the response is paged and the ContinuationToken, ResultCount and TotalCount values are returned as response headers; pass the ContinuationToken back via the `token` query parameter (or the ContinuationToken request header) to fetch the next page. Results are scoped to the assets the caller is permitted to see. - [Get Geofence Assets](https://developers.perspio.io/reference/getgeofenceassets.md): Returns the assets currently inside the geofence as hydrated asset states, including the entry timestamp. Use `signals` to limit which fields are returned. Scoped to the assets the caller is permitted to see. - [Get Geofence Asset Groups](https://developers.perspio.io/reference/getgeofenceassetgroups.md): Returns the asset groups associated with the geofence, scoped to the groups the caller is permitted to see. - [Update Geofence Asset Group](https://developers.perspio.io/reference/updategeofenceassetgroup.md): Adds or removes this geofence from one or more asset groups using a JSON Patch body (add/remove operations whose values are group ids). - [Get Toll Geofences](https://developers.perspio.io/reference/gettollgeofences.md): Returns all toll-gate geofences available to the tenant as GeoJSON. - [Get Toll Geofence](https://developers.perspio.io/reference/gettollgeofence.md): Returns a single toll-gate geofence by id as GeoJSON. Toll geofence ids use non-tenant formats (e.g. VIC-M3-50). - [Get Toll Geofence Events](https://developers.perspio.io/reference/gettollgeofenceevents.md): Returns toll-gate crossing events for the toll geofence, within an optional time range and severity filter. When `page_size` is supplied the response is paged and the ContinuationToken, ResultCount and TotalCount values are returned as response headers; pass the ContinuationToken back via the `token` query parameter (or the ContinuationToken request header) to fetch the next page. - [Get Region Geofences](https://developers.perspio.io/reference/getregiongeofences.md): Returns the region (administrative-boundary) geofences available to the tenant as GeoJSON. - [Get Zone Library Geofences](https://developers.perspio.io/reference/getzonegeofences.md): Returns the zone-library geofences available to the tenant as GeoJSON. - [Get Weather Alert Geofences](https://developers.perspio.io/reference/getweatheralertgeofences.md): Returns the active weather-alert geofences available to the tenant as GeoJSON. - [Get Asset Groups](https://developers.perspio.io/reference/getassetgroups-1.md): List the tenant's asset groups. - [Get Asset Group](https://developers.perspio.io/reference/getassetgroup.md): Fetch a single asset group by id. - [Create Asset Group](https://developers.perspio.io/reference/createggroup.md): Create a new asset or security group. - [Update Asset Group](https://developers.perspio.io/reference/updateassetgroup.md): Update assets in an asset group. - [Delete Asset Group](https://developers.perspio.io/reference/deletegroup.md): Delete an asset group by id. - [Copy Asset Group](https://developers.perspio.io/reference/copygroup.md): Create a copy of an existing asset group. - [Get Group Members](https://developers.perspio.io/reference/getgroupmembers.md): Fetch all assets of an asset group. - [Update Group Members](https://developers.perspio.io/reference/updategroupmembers.md): Replace the asset members of a group. - [Get Group Membership Changes](https://developers.perspio.io/reference/getgroupmembershipchanges.md): Fetch changes of an asset group. - [Update Security Group Dashboards](https://developers.perspio.io/reference/updatesecureddashboards.md): Replace the dashboards secured to a group. - [Update Security Group Geofences](https://developers.perspio.io/reference/updatesecuredgeofences.md): Replace the geofences secured to a group. - [Get Tenant Info](https://developers.perspio.io/reference/gettenantinfo.md): Return information about the current tenant. - [Update Tenant Info](https://developers.perspio.io/reference/updatetenantinfo.md): Update the tenant information. - [Get Tenant Config](https://developers.perspio.io/reference/gettenantconfig.md): Return the tenant configuration flags and values. - [Update Tenant Config](https://developers.perspio.io/reference/updatetenantconfig.md): Update the tenant configuration. - [Get Tenant Inventory](https://developers.perspio.io/reference/gettenantinventory.md): Fetch the inventory details of a tenant. - [Get System Jobs](https://developers.perspio.io/reference/getsystemjobs.md): Fetch the system job catalog. - [Get Invoices](https://developers.perspio.io/reference/getinvoices.md): Fetch all invoices of a tenant. - [Get Tenant Consumption](https://developers.perspio.io/reference/gettenantconsumption.md): Fetch the overall consumption data of a tenant. - [Get Tenant Actions Consumption](https://developers.perspio.io/reference/gettenantactionsconsumption.md): Fetch action-specific consumption data of a tenant. - [Get Tenant AI Consumption](https://developers.perspio.io/reference/gettenantaiconsumption.md): Fetch current-period AI usage, run counts, costs, effective quota, and optional breakdown by agent instance. - [Get Tenant Logo Images](https://developers.perspio.io/reference/getlogos.md): Fetch all logo images of a tenant. - [Get Tenant Logo Image](https://developers.perspio.io/reference/gettenantlogo.md): Fetch logo image of a tenant. - [Upload Tenant Logo](https://developers.perspio.io/reference/uploadtenantlogo.md): Upload a new logo image for the tenant. - [Delete Tenant Logo Images](https://developers.perspio.io/reference/deleteimages.md): Delete all logo images of a tenant. - [Get Notifications](https://developers.perspio.io/reference/getnotifications.md): List the active in-app notification banners. - [Get Notification](https://developers.perspio.io/reference/getnotification.md): Fetch a single notification banner by id. - [Get Entity Types](https://developers.perspio.io/reference/getentitytypes.md): Retrieve a list of all available entity types - [Get All Entity Schemas](https://developers.perspio.io/reference/getallentityschemas.md): Retrieve schemas for all entity types - [Get Entity Schema](https://developers.perspio.io/reference/getentityschema.md): Retrieve schema for a specific entity type - [Get Entity Data](https://developers.perspio.io/reference/getentitydata.md): Retrieve all data for a specific entity type. Any other query parameter whose name matches a property of the entity type (case-insensitive) is applied as an equality filter, e.g. ?branchName=Sydney; unknown or empty parameters are ignored. Without pageSize/continuationToken the full (filtered) list is returned as a bare array. - [Create Entity Data](https://developers.perspio.io/reference/createentitydata.md): Create a new entity record - [Update specific entity](https://developers.perspio.io/reference/updateentitydata.md): Updates a specific entity by ID. - [Bulk update entity data](https://developers.perspio.io/reference/bulkupdateentitydata.md): Updates multiple entities using transactional batch operations. - [Delete specific entity](https://developers.perspio.io/reference/deleteentitydata.md): Deletes a specific entity by ID. - [Bulk delete entity data](https://developers.perspio.io/reference/bulkdeleteentitydata.md): Deletes multiple entities by their IDs using transactional batch operations. - [Get App Versions](https://developers.perspio.io/reference/getappversions.md): Get Perspio App Versions. - [Get App Changelog](https://developers.perspio.io/reference/getappchangelog.md): Fetch the changelog entries and metadata for a specific app version. - [Get Drivers](https://developers.perspio.io/reference/getdrivers.md): List the tenant's drivers (people records). - [Get Driver](https://developers.perspio.io/reference/getdriver.md): Fetch a single driver (person) by id. - [Get Asset Marker Profiles](https://developers.perspio.io/reference/getassetmarkerprofiles.md): Fetch all asset marker profiles. - [Get Asset Marker Profile](https://developers.perspio.io/reference/getassetmarkerprofile.md): Fetch a single asset marker profile by id. - [Create Asset Marker Profile](https://developers.perspio.io/reference/createassetmarkerprofile.md): Create a new asset marker profile. - [Update Asset Marker Profile](https://developers.perspio.io/reference/updateassetmarkerprofile.md): Update a asset marker profile by id. - [Delete Asset Marker Profile](https://developers.perspio.io/reference/deleteassetmarkerprofile.md): Delete a asset marker profile by id. - [Get Custom Counters](https://developers.perspio.io/reference/getcustomcounterdefinitions.md): List the custom counter definitions. - [Get Custom Counter](https://developers.perspio.io/reference/getcustomcounterdefinition.md): Fetch a single custom counter definition by id. - [Create Custom Counter](https://developers.perspio.io/reference/createcustomcounterdefinition.md): Create a new custom counter definition. - [Update Custom Counter](https://developers.perspio.io/reference/updatecustocounterdefinition.md): Update a custom counter definition by id. - [Delete Custom Counter](https://developers.perspio.io/reference/deletecustomcounterdefinition.md): Delete a custom counter definition by id. - [Get Details Sharing Profiles](https://developers.perspio.io/reference/getdetailssharingprofiles.md): Fetch all details sharing profiles. - [Get Details Sharing Profile](https://developers.perspio.io/reference/getdetailsssharingprofile.md): Fetch a single details-sharing profile by id. - [Create Details Sharing Profile](https://developers.perspio.io/reference/createdetailssharingprofile.md): Create a new details-sharing profile. - [Update Details Sharing Profile](https://developers.perspio.io/reference/updatedetailssharingprofile.md): Update a details-sharing profile by id. - [Delete Details Sharing Profile](https://developers.perspio.io/reference/deletedetailssharingprofile.md): Delete a details-sharing profile by id. - [Get User Profiles](https://developers.perspio.io/reference/getuserprofiles.md): List the user (role) profiles for the tenant. - [Get User Profile](https://developers.perspio.io/reference/getuserprofile.md): Fetch a single user profile by id. - [Create User Profile](https://developers.perspio.io/reference/createuserprofile.md): Create a new user profile. - [Update User Profile](https://developers.perspio.io/reference/updateuserprofile.md): Update a user profile by id. - [Delete User Profile](https://developers.perspio.io/reference/deleteuserprofile.md): Delete a user profile by id. - [Get Working Hours Profiles](https://developers.perspio.io/reference/getworkinghoursprofiles.md): Fetch all working hours profiles. - [Get Working Hours Profile](https://developers.perspio.io/reference/getworkinghoursprofile.md): Fetch a single working-hours profile by id. - [Create Working Hours Profile](https://developers.perspio.io/reference/createworkinghoursprofile.md): Create a new working hours profile. - [Update Working Hours Profile](https://developers.perspio.io/reference/updateworkinghoursprofile.md): Update a working-hours profile by id. - [Delete Working Hours Profile](https://developers.perspio.io/reference/deleteworkinghoursprofile.md): Delete a working-hours profile by id. - [Get Shared Assets](https://developers.perspio.io/reference/getsharedassets.md): Return the assets shared via a public share token. - [Get Reports](https://developers.perspio.io/reference/getreports.md): List the tenant's report definitions. - [Get Report](https://developers.perspio.io/reference/getreport.md): Fetch a single report definition by id. - [Create Report](https://developers.perspio.io/reference/createreport.md): Create a new report definition. - [Update Report](https://developers.perspio.io/reference/updatereport.md): Update a report definition by id. - [Delete Report](https://developers.perspio.io/reference/deletereport.md): Delete a report definition by id. - [Get Report Data](https://developers.perspio.io/reference/getreportdata.md): Run a report and return its data. - [Create Report Data Job](https://developers.perspio.io/reference/createreportdatajob.md): Submit an asynchronous report-data job; returns 202 Accepted with the job reference. - [Get Report Schema](https://developers.perspio.io/reference/getreportschema.md): Fetch the schema for a report. - [Get Report Dictionaries](https://developers.perspio.io/reference/getreportdictionaries.md): List the report dictionaries (lookup metadata for report fields). - [Get Report History](https://developers.perspio.io/reference/getreporthistory.md): List the run history for a report. - [Get Tenant Scheduled Reports](https://developers.perspio.io/reference/gettenantscheduledreports.md): List the tenant's scheduled reports. - [Get Report Schedules](https://developers.perspio.io/reference/getreportschedules.md): Fetch all schedules of a report. - [Get Report Schedule](https://developers.perspio.io/reference/getreportschedule.md): Fetch a single report schedule by id. - [Create Report Schedule](https://developers.perspio.io/reference/createreportschedule.md): Create a new schedule for a report. - [Update Report Schedule](https://developers.perspio.io/reference/updatereportschedule.md): Update a report schedule by id. - [Delete Report Schedule](https://developers.perspio.io/reference/deletereportschedule.md): Delete a report schedule by id. - [Get Saved Reports](https://developers.perspio.io/reference/getsavedreports.md): List the saved report documents. - [Get Saved Report](https://developers.perspio.io/reference/getsavedreport.md): Fetch a saved report document by name. - [Estimate AI usage and cost before analysis](https://developers.perspio.io/reference/estimatereportdata.md): Estimate Perspio AI token burn and quota headroom for the same request shape as analyse. - [Validate AI analysis request](https://developers.perspio.io/reference/validatereportdata.md): Validate skill, report payload, and limits before running analyse. - [Analyse Report Data with AI](https://developers.perspio.io/reference/analysereportdata.md): Submit report data for AI analysis. On success, `metadata.perspioAITokens` is billed Perspio AI tokens (PATs), not the raw LLM `tokensUsed` count. - [List AI analysis runs for a report](https://developers.perspio.io/reference/getreportaihistory.md): Returns a paged list of recent AI runs for the calling user and report definition, newest first. Each item matches `AIReportHistoryItem` (PATs and run metadata; no model, raw provider token count, or estimated USD). Use `page_size` and the `token` header (continuation token) for pagination. Legacy `limit` is still accepted. - [Get AI run by id](https://developers.perspio.io/reference/getreportairun.md): Returns a single AI run as an analyse-shaped payload (AIAnalysisResponse) with inlined markdown content, so clients can reuse the analyse renderer. `metadata.perspioAITokens` is PATs (same as live analyse), not raw provider token usage. - [Global Search](https://developers.perspio.io/reference/globalsearch.md): Search the tenant's system-object cache - assets, devices, asset groups, geofences and rules - by free text, optionally restricted to a single Perspio object type and a set of asset types. Returns the matching objects grouped by type. - [Get Assets In Proximity](https://developers.perspio.io/reference/getassetsinproximity.md): Find assets within a radius of a point, ordered by distance. When history=true each asset includes its recent location history, bounded by the optional from/to date range. - [Get Object Dependency](https://developers.perspio.io/reference/getobjectdependencies.md): Return the objects that depend on the given object. Passthrough lookup endpoint. Optionally append `/{objectType}` (e.g. asset, device, geofence) to scope the lookup to a single object type; omitted returns dependents of all types. - [Get Saved Searches](https://developers.perspio.io/reference/getsavedsearches.md): Fetch the saved search artifacts of the given type, optionally filtered by owner email and a created-from date. - [Save Search](https://developers.perspio.io/reference/savesearch.md): Create and persist a new saved search artifact. Returns the saved artifact including its generated id. - [Edit Search](https://developers.perspio.io/reference/editsearch.md): Update an existing saved search artifact by id. Returns the updated artifact. - [Delete Saved Search](https://developers.perspio.io/reference/deletesavedsearch.md): Delete a saved search artifact by id. - [Get Service Programs](https://developers.perspio.io/reference/getserviceprograms.md): Fetch all service programs. - [Get Service Program](https://developers.perspio.io/reference/getserviceprogram.md): Get serviceprogram by id. - [Create Service Program](https://developers.perspio.io/reference/createserviceprogram-1.md): Create a new service program. - [Update Service Program](https://developers.perspio.io/reference/updateserviceprogram-1.md): Update service program by id. - [Delete Service Program](https://developers.perspio.io/reference/deleteserviceprogram-1.md): Delete service program by id. - [Get Service Program Assets](https://developers.perspio.io/reference/getserviceprogramassets.md): Fetch associated assets of a service program. - [Update Service Program Assets](https://developers.perspio.io/reference/updateserviceprogramassets-1.md): Update service program assets by id. - [Update Service Program Schedules](https://developers.perspio.io/reference/updateserviceprogramschedules-1.md): Update service program schedules by id. - [Get Service Schedules](https://developers.perspio.io/reference/getserviceschedules.md): Fetch all service schedules. - [Create Service Schedule](https://developers.perspio.io/reference/createserviceschedule-1.md): Create a new service schedule. - [Update Service Schedule](https://developers.perspio.io/reference/updateserviceschedule-1.md): Update service schedule by id. - [Delete Service Schedule](https://developers.perspio.io/reference/deleteserviceschedule-1.md): Delete service schedule by id. - [Get Service Reminders](https://developers.perspio.io/reference/getservicereminders-1.md): Fetch all service reminders. - [Get Service Reminder](https://developers.perspio.io/reference/getservicereminder-1.md): Get service reminder by id. - [Get Service Entries](https://developers.perspio.io/reference/getserviceentries.md): Fetch all service entries. - [Get Service Entry](https://developers.perspio.io/reference/getserviceentry.md): Get a single service entry by id. - [Create Service Entry](https://developers.perspio.io/reference/createserviceentry-1.md): Create a new service entry. - [Update Service Entry](https://developers.perspio.io/reference/updateserviceentry.md): Update linked reminders of a service entry. - [Delete Service Entry](https://developers.perspio.io/reference/deleteserviceentry-1.md): Delete service entry by id. - [Get Tasks](https://developers.perspio.io/reference/gettasks.md): Fetch the tenant's tasks, filtered by status and type and a created-date range. Returns task summaries; when full=true the response is paged and returns the full task records along with the ContinuationToken, ResultCount and TotalCount headers. - [Get Task](https://developers.perspio.io/reference/gettask.md): Fetch a single task by id. Returns the task summary; when full=true the complete task record is returned. - [Create Task](https://developers.perspio.io/reference/createtasks.md): Create a task of the given type with the supplied task object. Returns the summary of the newly created task. - [List Users](https://developers.perspio.io/reference/listusersv4.md): Fetch a paged list of users from the V4 user-management service. - [Get User](https://developers.perspio.io/reference/getuserv4.md): Fetch a user by principal id. - [Update User](https://developers.perspio.io/reference/updateuserv4.md): Patch supported user profile fields by principal id. - [Delete User](https://developers.perspio.io/reference/deleteuserv4.md): Remove a user by principal id. - [Enable User](https://developers.perspio.io/reference/enableuserv4.md): Enable a user's organization membership. - [Disable User](https://developers.perspio.io/reference/disableuserv4.md): Disable a user's organization membership. - [Resend Welcome Email](https://developers.perspio.io/reference/resendwelcomeemailv4.md): Reset the user's linked Entra password and send a welcome email. - [Create User Job](https://developers.perspio.io/reference/createuserjobv4.md): Create a background task for user creation using the legacy user-task backend. - [Get User Access](https://developers.perspio.io/reference/getuseraccessv4.md): Fetch a user's access assignment by principal id. - [Replace User Access](https://developers.perspio.io/reference/replaceuseraccessv4.md): Replace a user's access assignment by principal id. - [Get User Access Profiles](https://developers.perspio.io/reference/getroledefinitionprofilesv4.md): List the available role/access profiles. - [Get Users Preferences](https://developers.perspio.io/reference/getuserspreferencesv4.md): Fetch preferences for all non-staff users from the V4 user-management service. - [Get User Preferences](https://developers.perspio.io/reference/getuserpreferencesv4.md): Fetch preferences for a user by principal id. - [Update User Preferences](https://developers.perspio.io/reference/updateuserpreferencesv4.md): Patch preferences for a user by principal id. - [Get User Sign-In Logs](https://developers.perspio.io/reference/getusersigninlogsv4.md): Fetch WorkOS-backed sign-in logs for a user within a maximum 30-day date range. - [Get User Logs](https://developers.perspio.io/reference/getuserlogsv4.md): Retrieve user audit logs. - [Create User Log](https://developers.perspio.io/reference/createuserlogv4.md): Write a user audit log entry. - [Get Current User](https://developers.perspio.io/reference/getcurrentuserv4.md): Fetch the authenticated user. - [Update Current User](https://developers.perspio.io/reference/updatecurrentuserv4.md): Patch supported fields for the authenticated user. - [Get Current User Preferences](https://developers.perspio.io/reference/getcurrentuserpreferencesv4.md): Fetch preferences for the authenticated user. - [Update Current User Preferences](https://developers.perspio.io/reference/updatecurrentuserpreferencesv4.md): Patch preferences for the authenticated user. - [Get Current User Access](https://developers.perspio.io/reference/getcurrentuseraccessv4.md): Fetch the authenticated user's access assignment. - [Update Current User Access](https://developers.perspio.io/reference/updatecurrentuseraccessv4.md): Patch the authenticated user's access assignment. - [Get Current User Logs](https://developers.perspio.io/reference/getcurrentuserlogsv4.md): Retrieve recent activity logs for the authenticated user. - [Create Support Ticket](https://developers.perspio.io/reference/createsupportticketv4.md): Create a support ticket for the authenticated user. - [Get Workflows](https://developers.perspio.io/reference/getworkflows.md): List workflows within the current tenant. - [Get Workflow](https://developers.perspio.io/reference/getworkflow.md): Get workflow within the current tenant. - [Update Workflow](https://developers.perspio.io/reference/updateworkflow.md): Update workflow by id within the current tenant. - [Delete Workflow](https://developers.perspio.io/reference/deleteworkflow.md): Delete workflow by id within the current tenant. - [Copy Workflow](https://developers.perspio.io/reference/copyworkflow.md): Copy a workflow to a new workflow. The copy is always created disabled. The request body is optional: a non-blank name and/or description overrides the corresponding default and is trimmed. Values that are omitted, null or blank (whitespace only) fall back to their defaults - the copy is named 'Copy of ' and keeps the original workflow's description. - [Workflow Manual Trigger](https://developers.perspio.io/reference/workflowmanualtrigger.md): Create a manual trigger for a workflow. - [Get Workflow Trigger History](https://developers.perspio.io/reference/getworkflowtriggerhistory.md): Fetch trigger history for a specific workflow. - [Get Workflow History Metrics Count](https://developers.perspio.io/reference/getworkflowhistorymetricscount.md): Get workflowhistory metrics count. - [Get Workflow History Metrics Count with Actions](https://developers.perspio.io/reference/getworkflowhistorymetricscount2.md): Fetch trigger count of workflow with Actions. - [Get Workflow Checkpoints](https://developers.perspio.io/reference/getworkflowcheckpoints.md): Fetch checkpoints of a workflow. - [Unsuppress Workflow Checkpoint](https://developers.perspio.io/reference/unsuppressworkflowcheckpoint.md): Create a request to unsuppress checkpoint of a workflow. - [Unsuppress Workflow Object Checkpoint](https://developers.perspio.io/reference/unsuppressworkflowobjectcheckpoint.md): Create a request to unsuppress a workflow object checkpoint. - [Get Event Types](https://developers.perspio.io/reference/geteventtypes.md): List event types within the current tenant. - [Get Metadata](https://developers.perspio.io/reference/getmetadata.md): Get metadata within the current tenant. - [Get Groups](https://developers.perspio.io/reference/getgroups-1.md): List groups within the current tenant. - [Get Assets](https://developers.perspio.io/reference/getassets-1.md): List assets within the current tenant. - [Get Workflow Scope Assets](https://developers.perspio.io/reference/getworkflowscopeassets.md): Create a request to fetch assets from scope of a workflow. - [Get Data Schema From workflow Scope](https://developers.perspio.io/reference/getrulescopedataschema.md): Create a request to fetch data schema from scope of a workflow.