# Nile Workspaces API

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

The Workspaces API from Nile — 17 operation(s) for workspaces.

## Operations (19)

| Method | Path | Summary |
|---|---|---|
| GET | `/workspaces/{workspaceSlug}/databases/{databaseName}/tenants` | List tenants |
| GET | `/workspaces/{workspaceSlug}/invites` | List developer invites |
| POST | `/workspaces/{workspaceSlug}/invites` | Invite a developer to a workspace |
| DELETE | `/workspaces/{workspaceSlug}/invites/{inviteId}` | Deletes a previously issued invite |
| POST | `/workspaces/{workspaceSlug}/invites/{inviteId}/resend` | Resend an existing workspace invitation |
| GET | `/workspaces/{workspaceSlug}/metrics/compute` | List workspace compute metrics |
| GET | `/workspaces` | List workspaces |
| POST | `/workspaces` | Create a workspace |
| GET | `/workspaces/{workspaceSlug}` | Get a workspace |
| GET | `/workspaces/{workspaceSlug}/compute-types` | List available compute types |
| GET | `/workspaces/{workspaceSlug}/developers` | List developers with access to a workspace |
| DELETE | `/workspaces/{workspaceSlug}/developers/{developerId}` | Remove a developer from a workspace |
| GET | `/workspaces/{workspaceSlug}/billing/{ym}/history` | Get cumulative daily workspace costs |
| PUT | `/workspaces/{workspaceSlug}/billing/customer` | Ensure workspace billing customer |
| GET | `/workspaces/{workspaceSlug}/billing/readiness` | Get workspace billing readiness |
| GET | `/workspaces/{workspaceSlug}/subscription` | Get current subscription (from DB) |
| GET | `/workspaces/{workspaceSlug}/subscription/history` | List subscription history (most-recent first) |
| GET | `/workspaces/{workspaceSlug}/billing/{ym}/totals` | Monthly totals by component, from rated lines |
| GET | `/workspaces/{workspaceSlug}/insights/usage` | Get observed workspace usage |

## Machine-readable artifacts (18)

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

## Tags

Workspace

---

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