# Nile Users API

**Canonical:** https://apis.io/apis/thenile/thenile-users-api/  
**Provider:** Nile — https://apis.io/providers/thenile/  
**Base URL:** https://global.thenile.dev  
**Documentation:** https://www.thenile.dev/docs/api-reference/post-oauth2token

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

The users API from Nile — 27 operation(s) for users.

## Operations (37)

| Method | Path | Summary |
|---|---|---|
| GET | `/workspaces/{workspaceSlug}/databases/{databaseName}/tenants/{tenantId}/auth/oidc/callback` | Handle OIDC callback for a tenant user |
| GET | `/workspaces/{workspaceSlug}/databases/{databaseName}/tenants/{tenantId}/users` | List tenant users |
| POST | `/workspaces/{workspaceSlug}/databases/{databaseName}/tenants/{tenantId}/users` | Create a user in a tenant |
| GET | `/workspaces/{workspaceSlug}/databases/{databaseName}/tenants/{tenantId}/users/{userId}` | Get a user in a tenant |
| POST | `/workspaces/{workspaceSlug}/databases/{databaseName}/tenants/{tenantId}/users/login` | Login a user in a tenant |
| GET | `/workspaces/{workspaceSlug}/databases/{databaseName}/users/{userId}` | Get a user |
| PUT | `/workspaces/{workspaceSlug}/databases/{databaseName}/users/{userId}` | Update a user |
| DELETE | `/workspaces/{workspaceSlug}/databases/{databaseName}/users/{userId}` | Delete a user |
| GET | `/workspaces/{workspaceSlug}/databases/{databaseName}/users/oidc/callback` | Handle OIDC callback for a user |
| GET | `/workspaces/{workspaceSlug}/databases/{databaseName}/users/me` | Identify the user |
| GET | `/workspaces/{workspaceSlug}/databases/{databaseName}/users` | List database users |
| POST | `/workspaces/{workspaceSlug}/databases/{databaseName}/users/login` | Login a user |
| GET | `/workspaces/{workspaceSlug}/databases/{databaseName}/users/oidc/{providerName}/login` | Initiate OIDC user login |
| GET | `/databases/{databaseId}/tenants/{tenantId}/auth/oidc/callback` | Handle OIDC callback for a tenant user |
| GET | `/databases/{databaseId}/tenants/{tenantId}/users` | List tenant users |
| POST | `/databases/{databaseId}/tenants/{tenantId}/users` | Create a user in a tenant |
| GET | `/databases/{databaseId}/tenants/{tenantId}/users/{userId}` | Get a user in a tenant |
| POST | `/databases/{databaseId}/tenants/{tenantId}/users/login` | Login a user in a tenant |
| GET | `/databases/{databaseId}/users/{userId}` | Get a user |
| PUT | `/databases/{databaseId}/users/{userId}` | Update a user |
| DELETE | `/databases/{databaseId}/users/{userId}` | Delete a user |
| GET | `/databases/{databaseId}/users` | List database users |
| POST | `/databases/{databaseId}/users` | Create a new user |
| GET | `/databases/{databaseId}/users/oidc/callback` | Handle OIDC callback for a user |
| GET | `/databases/{databaseId}/users/me` | Identify the user |
| POST | `/databases/{databaseId}/users/login` | Login a user |
| GET | `/databases/{databaseId}/users/oidc/{providerName}/login` | Initiate OIDC user login |
| GET | `/v2/databases/{database}/me` | Identify the principal |
| PUT | `/v2/databases/{database}/me` | Update the principal profile |
| POST | `/v2/databases/{database}/signup` | Signs up a new user |
| PUT | `/v2/databases/{database}/tenants/{tenantId}/users/{userId}/link` | links an existing user to a tenant |
| DELETE | `/v2/databases/{database}/tenants/{tenantId}/users/{userId}/link` | Unlinks a user from a tenant |
| PUT | `/v2/databases/{database}/tenants/{tenantId}/users/{userId}` | update a user |
| GET | `/v2/databases/{database}/tenants/{tenantId}/users` | a list of tenant users |
| POST | `/v2/databases/{database}/tenants/{tenantId}/users` | create a new user and assigns them to a tenant |
| GET | `/v2/databases/{database}/users/{userId}/tenants` | lists tenants of user |
| POST | `/v2/databases/{database}/users` | Creates a user |

## Machine-readable artifacts (18)

- **OpenAPI** — https://artifacts.apis.io/thenile/openapi/thenile-users-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/thenile/json-schema/thenile-apierror-schema.json
- **JSONSchema** — https://artifacts.apis.io/thenile/json-schema/thenile-create-database-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/thenile/json-schema/thenile-get-database-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/thenile/json-schema/thenile-dedicated-compute-instance-schema.json
- **JSONSchema** — https://artifacts.apis.io/thenile/json-schema/thenile-unauthenticated-provision-database-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/thenile/json-schema/thenile-workspace-usage-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/thenile/json-schema/thenile-oidcprovider-schema.json
- **JSONSchema** — https://artifacts.apis.io/thenile/json-schema/thenile-user-schema.json
- **JSONSchema** — https://artifacts.apis.io/thenile/json-schema/thenile-tenant-ssoregistration-schema.json
- **JSONSchema** — https://artifacts.apis.io/thenile/json-schema/thenile-logical-database-schema.json
- **JSONSchema** — https://artifacts.apis.io/thenile/json-schema/thenile-oidcrelying-party-schema.json
- **JSONSchema** — https://artifacts.apis.io/thenile/json-schema/thenile-create-basic-user-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/thenile/json-schema/thenile-mfa-setup-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/thenile/json-schema/thenile-mfa-disable-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/thenile/json-schema/thenile-tenant-user-schema.json
- **JSONSchema** — https://artifacts.apis.io/thenile/json-schema/thenile-mfa-verify-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/thenile/json-schema/thenile-mfa-verify-response-schema.json

## Other Nile APIs (9)

- [Nile Auth API](https://apis.io/apis/thenile/thenile-auth-api/)
- [Nile Authentication API](https://apis.io/apis/thenile/thenile-authentication-api/)
- [Nile Compute API](https://apis.io/apis/thenile/thenile-compute-api/)
- [Nile Credentials API](https://apis.io/apis/thenile/thenile-credentials-api/)
- [Nile Databases API](https://apis.io/apis/thenile/thenile-databases-api/)
- [Nile Developers API](https://apis.io/apis/thenile/thenile-developers-api/)
- [Nile Internal API](https://apis.io/apis/thenile/thenile-internal-api/)
- [Nile Tenants API](https://apis.io/apis/thenile/thenile-tenants-api/)
- [Nile Workspaces API](https://apis.io/apis/thenile/thenile-workspaces-api/)

## Tags

User

---

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