# Nile Authentication API

**Canonical:** https://apis.io/apis/thenile/thenile-authentication-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 Authentication 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 Authentication. The published artifact set on APIs.io includes an OpenAPI specification and 17 JSON Schemas.

The authentication API from Nile — 18 operation(s) for authentication.

## Operations (27)

| Method | Path | Summary |
|---|---|---|
| GET | `/workspaces/{workspaceSlug}/databases/{databaseName}/tenants/auth/oidc/locations` | List SSO URLs |
| GET | `/workspaces/{workspaceSlug}/databases/{databaseName}/tenants/auth/oidc/providers` | List registered SSO providers |
| GET | `/workspaces/{workspaceSlug}/databases/{databaseName}/tenants/{tenantId}/auth/oidc/providers/{providerName}` | Get SSO registration |
| PUT | `/workspaces/{workspaceSlug}/databases/{databaseName}/tenants/{tenantId}/auth/oidc/providers/{providerName}` | Update tenant SSO provider |
| POST | `/workspaces/{workspaceSlug}/databases/{databaseName}/tenants/{tenantId}/auth/oidc/providers/{providerName}` | Register tenant SSO provider |
| GET | `/workspaces/{workspaceSlug}/databases/{databaseName}/tenants/{tenantId}/auth/oidc/providers` | List SSO registrations |
| GET | `/workspaces/{workspaceSlug}/databases/{databaseName}/tenants/{tenantId}/auth/oidc/providers/{providerName}/login` | Initiate OIDC login for a tenant |
| GET | `/databases/{databaseId}/auth/oidc/providers` | List OIDC providers |
| POST | `/databases/{databaseId}/auth/oidc/providers` | Create OIDC provider |
| GET | `/databases/{databaseId}/auth/oidc/providers/{providerName}` | Get an OIDC provider |
| PUT | `/databases/{databaseId}/auth/oidc/providers/{providerName}` | Update OIDC provider |
| GET | `/databases/{databaseId}/auth/oidc/relyingparties` | List relying parties |
| PUT | `/databases/{databaseId}/auth/oidc/relyingparties` | Update relying party |
| POST | `/databases/{databaseId}/auth/oidc/relyingparties` | Create relying party |
| GET | `/databases/{databaseId}/auth/oidc/relyingparties/{relyingPartyId}` | Get a relying party |
| GET | `/databases/{databaseId}/tenants/auth/oidc/locations` | List SSO URLs |
| GET | `/databases/{databaseId}/tenants/auth/oidc/providers` | List registered SSO providers |
| GET | `/databases/{databaseId}/tenants/{tenantId}/auth/oidc/providers/{providerName}` | Get SSO registration |
| PUT | `/databases/{databaseId}/tenants/{tenantId}/auth/oidc/providers/{providerName}` | Update tenant SSO provider |
| POST | `/databases/{databaseId}/tenants/{tenantId}/auth/oidc/providers/{providerName}` | Register tenant SSO provider |
| GET | `/databases/{databaseId}/tenants/{tenantId}/auth/oidc/providers` | List SSO registrations |
| GET | `/databases/{databaseId}/tenants/{tenantId}/auth/oidc/providers/{providerName}/login` | Initiate OIDC login for a tenant |
| GET | `/workspaces/{workspaceSlug}/databases/{databaseName}/credentials` | Lists credentials for a database |
| POST | `/workspaces/{workspaceSlug}/databases/{databaseName}/credentials` | Create a database credential |
| DELETE | `/workspaces/{workspaceSlug}/databases/{databaseName}/credentials/{credentialId}` | Delete a database credential |
| POST | `/workspaces/{workspaceSlug}/databases/{databaseName}/credentials/rotate` | Rotate a database credential |
| POST | `/oauth2/token` | Exchange an authorization code or refresh token |

## Machine-readable artifacts (18)

- **OpenAPI** — https://artifacts.apis.io/thenile/openapi/thenile-authentication-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 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 Users API](https://apis.io/apis/thenile/thenile-users-api/)
- [Nile Workspaces API](https://apis.io/apis/thenile/thenile-workspaces-api/)

## Tags

Authentication

---

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