# Ringover Users API

**Canonical:** https://apis.io/apis/ringover/ringover-users-api/  
**Provider:** Ringover — https://apis.io/providers/ringover/  
**Base URL:** https://public-api.ringover.com/v2  
**Documentation:** https://developer.ringover.com/

Ringover Users API is one of 28 APIs that [Ringover](https://apis.io/providers/ringover/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include users. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Manage your Ringover team members. Retrieve user information, manage plannings, check availability (presences/snooze), and organize user blacklists. **Permissions required:** - **Read** (`Users R`): Get user details, plannings, presences, user blacklists. - **Write** (`Users W`): Modify plannings, manage group members, manage user blacklists, modify snooze status. **Monitoring impact:** - *OFF*: GET requests return **only your own** user data, planning, and presence. Group listing returns only groups you belong to. - *ON*: GET requests return **all team** users, plannings, and presences. You can modify **any user's** planning. > Some write operations (plannings, group membership) **require** Monitoring ON and will return `401` without it.

## Operations (12)

| Method | Path | Summary |
|---|---|---|
| GET | `/users` | List all team users |
| POST | `/users` | Create a user (deprecated — use /users/invite) |
| GET | `/users/{userId}` | Get a user by ID |
| DELETE | `/users/{userId}` | Delete or archive a user |
| POST | `/users/{userId}/profiles/{profileId}` | Assign a profile to a user |
| GET | `/users/{userId}/plannings` | Get a user's weekly planning |
| PUT | `/users/{userId}/plannings` | Replace a user's entire weekly planning |
| PUT | `/users/{userId}/plannings/{day}` | Replace a user's planning for a specific day |
| GET | `/users/{userId}/presences` | Get a user's presence status |
| GET | `/users/{userId}/snooze/log` | Get a user's snooze history |
| PUT | `/users/{userId}/snooze` | Set or clear a user's snooze status |
| POST | `/users/invite` | Invite multiple users to the team |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/ringover/openapi/ringover-users-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/ringover/json-schema/ringover-calls-filter-schema.json
- **JSONSchema** — https://artifacts.apis.io/ringover/json-schema/ringover-empower-logs-calls-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/ringover/json-schema/ringover-empower-logs-calls-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/ringover/json-schema/ringover-call-empower-schema.json
- **JSONSchema** — https://artifacts.apis.io/ringover/json-schema/ringover-conversation-light-schema.json
- **JSONSchema** — https://artifacts.apis.io/ringover/json-schema/ringover-get-call-empower-res-body-schema.json

## Other Ringover APIs (12)

- [Ringover Blacklist API](https://apis.io/apis/ringover/ringover-blacklist-api/)
- [Ringover Callbacks API](https://apis.io/apis/ringover/ringover-callbacks-api/)
- [Ringover Calls API](https://apis.io/apis/ringover/ringover-calls-api/)
- [Ringover Campaigns API](https://apis.io/apis/ringover/ringover-campaigns-api/)
- [Ringover Cdn API](https://apis.io/apis/ringover/ringover-cdn-api/)
- [Ringover Channels API](https://apis.io/apis/ringover/ringover-channels-api/)
- [Ringover Conferences API](https://apis.io/apis/ringover/ringover-conferences-api/)
- [Ringover Contacts API](https://apis.io/apis/ringover/ringover-contacts-api/)
- [Ringover Conversations API](https://apis.io/apis/ringover/ringover-conversations-api/)
- [Ringover Empower API](https://apis.io/apis/ringover/ringover-empower-api/)
- [Ringover Groups API](https://apis.io/apis/ringover/ringover-groups-api/)
- [Ringover Ivrs API](https://apis.io/apis/ringover/ringover-ivrs-api/)

## Tags

users

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/ringover/ringover-users-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/ringover/.