canonical: https://jentic.com/apis/truesight.local/truesight-local

# Truesight Hardware Sentry TrueSight Presentation Server REST API

Hardware Sentry TrueSight Presentation Server REST API. The API exposes 23 endpoints secured with apiKey authentication.

## For AI agents

Programmatically triggers a new collect on a specific device., triggers a new discovery on a specific device.. Covers 23 operations with apiKey authentication.

## Scope

Does not handle payments, communications, or crm - use for iot and hardware only.

## Capabilities

- Triggers a new collect on a specific device.
- Sends a 'Reinitialize KM' command.
- Removes a specific instance from the monitoring environment.
- Resets the Error Count parameter.
- Gets summarized information about all monitored applications.

## Use cases

### IoT and Hardware Operations

Use the Hardware Sentry TrueSight Presentation Server REST API to perform iot operations programmatically. The API provides 23 endpoints covering core functionality including triggers a new collect on a specific device., triggers a new discovery on a specific device., sends a 'reinitialize km' command..

Example prompt: Call POST `/hardware/actions/{deviceId}/collect-now` to triggers a new collect on a specific device.

### Automated Actions Management

Automate actions operations by combining multiple Hardware Sentry TrueSight Presentation Server REST API endpoints. Agents can triggers a new discovery on a specific device. and then sends a 'reinitialize km' command. in a single workflow.

Example prompt: Call POST `/hardware/actions/{deviceId}/rediscover` to triggers a new discovery on a specific device., then verify the result

### AI Agent Integration via Jentic

AI agents discover and call Hardware Sentry TrueSight Presentation Server REST API endpoints through Jentic without managing credentials directly. An agent searches for the required operation by intent, receives the matching endpoint schema, and executes the call with Jentic-managed authentication. This eliminates the need to read API documentation or handle apiKey tokens manually.

Example prompt: Search Jentic for 'triggers a new collect on a specific device.', load the operation schema, and execute with Jentic-managed credentials

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| POST | `/hardware/actions/{deviceId}/collect-now` | Triggers a new collect on a specific device. |
| POST | `/hardware/actions/{deviceId}/rediscover` | Triggers a new discovery on a specific device. |
| POST | `/hardware/actions/{deviceId}/reinitialize` | Sends a 'Reinitialize KM' command. |
| POST | `/hardware/actions/{deviceId}/remove` | Removes a specific instance from the monitoring environment. |
| POST | `/hardware/actions/{deviceId}/reset-error-count` | Resets the Error Count parameter. |
| GET | `/hardware/applications` | Gets summarized information about all monitored applications. |
| GET | `/hardware/applications/{applicationId}` | Gets detailed information for a specific application. |
| GET | `/hardware/device-monitors/{deviceId}` | Gets the Monitors for a specific device. |

## Key resources

- **Actions** — API operations to interact with the PATROL Agent.
- **Applications** — API operations to interact with the monitored Applications.
- **Devices** — API operations to interact with the monitored Devices.
- **Groups** — API operations to interact with the monitored Groups.
- **Historical Data** — API operations to get historical data.

## Why Jentic

- **Setup:** Wiring Hardware Sentry TrueSight Presentation Server REST API by hand means passing its session cookie on every call, pointing at your own presentation server host and port, and handling errors and retries yourself. Through Jentic you install once, import Hardware Sentry TrueSight Presentation Server REST API from the API Directory, store the credential once, and your agent calls it.
- **Permission scoping:** Hardware Sentry TrueSight Presentation Server REST API puts the device id in the URL path (`/hardware/actions/{deviceId}/...`), so a rule can pin your agent to one device: it can trigger a collection or read that device's monitors and nothing else. You choose the operations it may call, so device removal or reinitialize are not included unless you add them.
- **Credential handling:** Your Hardware Sentry TrueSight Presentation Server REST API credential is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'trigger a collection on a device' or 'list monitored applications', and Jentic returns the matching Hardware Sentry TrueSight Presentation Server REST API operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Particle** — Alternative iot API
- **Stripe** — Complementary API for broader integration workflows
- **Twilio** — Complementary API for broader integration workflows

## FAQ

### What authentication does the Hardware Sentry TrueSight Presentation Server REST API use?

The Hardware Sentry TrueSight Presentation Server REST API uses an API key passed in the `Cookie` header. Through Jentic, these credentials are stored encrypted in your Jentic One instance and injected at execution time, so raw secrets never enter the agent context.

### Can I triggers a new collect on a specific device. with the Hardware Sentry TrueSight Presentation Server REST API?

Yes. Use the POST `/hardware/actions/{deviceId}/collect-now` endpoint. The API returns structured JSON responses that agents can parse and act on directly.

### What are the rate limits for the Hardware Sentry TrueSight Presentation Server REST API?

Rate limits are not specified in the OpenAPI spec. Check the vendor documentation for current limits. Through Jentic, rate limiting is handled automatically with retry logic built into the execution layer.

### How do I triggers a new collect on a specific device. through Jentic?

Install the Jentic SDK with pip install jentic, authenticate through Jentic One, the self-hosted execution layer, then search for 'triggers a new collect on a specific device.'. Jentic returns the matching Hardware Sentry TrueSight Presentation Server REST API operation with its input schema. Load the schema and execute the call - credentials are injected automatically.

### How many endpoints does the Hardware Sentry TrueSight Presentation Server REST API have?

The Hardware Sentry TrueSight Presentation Server REST API exposes 23 endpoints covering actions, applications, devices operations.

### Can I limit what my agent is allowed to do with the Hardware Sentry TrueSight Presentation Server REST API?

Yes. Because you run Jentic One yourself, your own rules decide which of this API's operations and credentials the agent can use. This API puts the device id in the URL path, such as `/hardware/actions/{deviceId}/collect-now` and `/hardware/device-monitors/{deviceId}`, so you can pin the agent to a single device and grant it only read access to that device's monitors or the ability to trigger a collection. Destructive operations like device removal or the reinitialize command stay out of reach unless you explicitly add them.