# Hoops API Documentation

This is the complete API documentation for connecting to the Hoops API using MindCloud's Universal API.

MindCloud offers one normalized API to access 3,400+ apps from a single place. It centralizes authentication and normalizes app APIs so they are easier and more consistent to use.

## Quickstart

1. A **MindCloud account** — sign in or create an account at [MindCloud](https://app.mindcloud.co).
2. A **MindCloud API Key** — create one in [API Keys](https://app.mindcloud.co/user/api-keys). Keep it on your server.
3. At least one **Hoops connection** — create or choose one in [Connections](https://app.mindcloud.co/credentials). Note its `connectionId`.

```text
POST https://connect.mindcloud.co/v2/universal/apps/hoops/actions/{actionSlug}/run
```

## Hoops actions

- POST `create-agent-key` Create Agent Key
- POST `create-connection` Create Connection
- POST `create-service-account` Create Service Account
- POST `create-session` Create Session
- POST `create-user` Create User
- DELETE `delete-agent-key` Delete Agent Key
- DELETE `delete-connection` Delete Connection
- DELETE `delete-user` Delete User
- GET `get-connection` Get Connection
- GET `get-review` Get Review
- GET `get-session` Get Session
- GET `get-user` Get User
- GET `get-user-info` Get User Info
- DELETE `kill-session` Kill Session
- GET `list-agent-keys` List Agent Keys
- GET `list-connections` List Connections
- GET `list-reviews` List Reviews
- GET `list-runbooks` List Runbooks
- GET `list-service-accounts` List Service Accounts
- GET `list-sessions` List Sessions
- GET `list-users` List Users
- PUT `reviewed-exec` Reviewed Exec
- POST `runbook-exec` Runbook Exec
- GET `search` Search
- GET `test-connection` Test Connection
- PUT `update-connection` Update Connection
- PUT `update-review-status` Update Review Status
- PUT `update-service-account` Update Service Account
- PUT `update-session-metadata` Update Session Metadata
- PUT `update-user` Update User