canonical: https://jentic.com/apis/slmonitor.com/slmonitor

# Slmonitor SafetyLine

slmonitor.com/main version 2.1. The API exposes 19 endpoints secured with oauth2 authentication.

## For AI agents

Programmatically gets a suggested check-in message based on the surroundings, get the authenticated user. Covers 19 operations with oauth2 authentication.

## Scope

Does not handle payments, communications, or crm - use for developer tools only.

## Capabilities

- Gets a suggested check-in message based on the surroundings
- Get the authenticated user
- Check in
- Query and filter SafetyLine records by parameters
- Monitor SafetyLine operational status and events

## Use cases

### Developer Tools Operations

Use the SafetyLine to perform developer tools operations programmatically. The API provides 19 endpoints covering core functionality including gets a suggested check-in message based on the surroundings, get the authenticated user, get the user's monitor notifications.

Example prompt: Call POST `/api/v2.1/companies/{companyId}/checkin-text-suggestion` to gets a suggested check-in message based on the surroundings

### Automated V2.1 Management

Automate v2.1 operations by combining multiple SafetyLine endpoints. Agents can get the authenticated user and then get the user's monitor notifications in a single workflow.

Example prompt: Call GET `/api/v2.1/companies/{companyId}/me` to get the authenticated user, then verify the result

### AI Agent Integration via Jentic

AI agents discover and call SafetyLine 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 oauth2 tokens manually.

Example prompt: Search Jentic for 'gets a suggested check-in message based on the surroundings', load the operation schema, and execute with Jentic-managed credentials

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| POST | `/api/v2.1/companies/{companyId}/checkin-text-suggestion` | Gets a suggested check-in message based on the surroundings |
| GET | `/api/v2.1/companies/{companyId}/me` | Get the authenticated user |
| GET | `/api/v2.1/companies/{companyId}/monitors/{uniqueUserId}/notifications` | Get the user's monitor notifications |
| GET | `/api/v2.1/companies/{companyId}/users` | Get all the users |
| GET | `/api/v2.1/companies/{companyId}/users/events` | Get the user events within a specified time range. |
| GET | `/api/v2.1/companies/{companyId}/users/{uniqueUserId}` | Get the user's profile |
| POST | `/api/v2.1/companies/{companyId}/users/{uniqueUserId}/checkin` | Check in |
| POST | `/api/v2.1/companies/{companyId}/users/{uniqueUserId}/checkin-audio` | Check in with an audio recording |

## Key resources

- **V2.1** — Operations for v2.1

## AI readiness

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

- **Score:** 62 / 100
- **Maturity:** AI-Aware
- **Dimensions:**
  - Foundational Compliance: 99 / 100
  - Developer Experience & Jentic Compatibility: 63 / 100
  - AI-Readiness & Agent Experience: 50 / 100
  - Agent Usability: 94 / 100
  - Security: 35 / 100
  - AI Discoverability: 71 / 100
- **View full report:** https://jentic.com/apis/slmonitor.com/slmonitor/scorecard
- **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/
- **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview

### Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

- **Score your own API:** https://jentic.com/scorecard.md
- **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md

```sh
npx @jentic/api-scorecard-cli score <openapi-url>
```

## Why Jentic

- **Setup:** Wiring SafetyLine by hand means running its OAuth 2.0 implicit flow against the b2clogin authorization endpoint, requesting the access_as_user scope, and refreshing sign-in yourself before calls to api.slmonitor.com. Through Jentic you install once, import SafetyLine from the API Directory, store the OAuth credentials once, and your agent calls it.
- **Permission scoping:** SafetyLine puts the company id and user id in the URL path (`/api/v2.1/companies/{companyId}/users/{uniqueUserId}`), so a rule can pin your agent to one company and its users. You choose the operations it may call, so if you only grant reads of users and events, the check-in operations are not included unless you add them.
- **Credential handling:** Your SafetyLine OAuth credentials are stored once, encrypted, by your own Jentic One instance and injected at execution time. They never enter the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'list users for a company' or 'submit a user check-in', and Jentic returns the matching SafetyLine operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Github** — Alternative developer tools API
- **Gitlab** — Alternative developer tools API

## FAQ

### What authentication does the SafetyLine use?

The SafetyLine uses OAuth 2.0 for authorization. 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 gets a suggested check-in message based on the surroundings with the SafetyLine?

Yes. Use the POST `/api/v2.1/companies/{companyId}/checkin-text-suggestion` endpoint. The API returns structured JSON responses that agents can parse and act on directly.

### What are the rate limits for the SafetyLine?

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 gets a suggested check-in message based on the surroundings through Jentic?

Install the Jentic SDK with pip install jentic, authenticate through Jentic One, the self-hosted execution layer, then search for 'gets a suggested check-in message based on the surroundings'. Jentic returns the matching SafetyLine operation with its input schema. Load the schema and execute the call - credentials are injected automatically.

### How many endpoints does the SafetyLine have?

The SafetyLine exposes 19 endpoints covering v2.1 operations.

### Can I limit what my agent is allowed to do with the SafetyLine API?

Yes. Jentic One is self-hosted by you, so your own rules decide which SafetyLine operations and credentials the agent may use. Because SafetyLine puts the company id and user id in the URL path, such as `/api/v2.1/companies/{companyId}/users/{uniqueUserId}`, you can pin the agent to a single company and its users. You can also grant only the operations you want, so if you allow reads of users and events, the check-in and check-in-audio operations stay off limits until you add them.