> Index of these docs for agents: [/llms.txt](/llms.txt)

# Plix API

Read an organization's cameras, people, locations, events and recordings, and start and stop livestreams, shifts and recordings on its cameras. People can also connect an AI assistant to Plix; see the connector guide.

## API

For your own system. A credential issued to your organization answers for that organization's data.

- Base URL: `https://beaver.plix.ai`
- [OpenAPI description](/v1/openapi.json): every endpoint, parameter, response and error, as JSON
- [Plain-text guide](/llms.txt): how to sign in and get access, with one line per endpoint
- [Reference page](/docs): the same description, rendered for people

## Assistant connector

For a person's AI assistant, which signs in as that person.

- MCP endpoint: `https://beaver.plix.ai/mcp`
- [Connector guide](/docs/connector.md): who can use it, setup steps for each assistant, its tools, limits and troubleshooting

## Which to use

- Use the **API** (`/v1`) when your own system calls Plix. It uses a credential issued to your organization
  and answers for the whole organization. Its reference is [/v1/openapi.json](/v1/openapi.json).
- Use the **connector** when a person asks an assistant about their own work in Plix. The assistant signs in
  as that person and reaches what they reach.

The two do not cover the same ground yet. Coaching and transcripts are on the connector. Camera control,
locations and device data are on the API.
