# Granite Workspaces API

**Canonical:** https://apis.io/apis/granite-md/granite-md-workspaces-api/  
**Provider:** Granite — https://apis.io/providers/granite-md/  
**Base URL:** https://api.granite.md  
**Documentation:** https://docs.granite.md/

Granite Workspaces API is one of 19 APIs that [Granite](https://apis.io/providers/granite-md/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 1 JSON Schema definition. Tagged areas include Workspace. The published artifact set on APIs.io includes an OpenAPI specification and 1 JSON Schema.

Company workspaces (Business plan): members with roles (owner, admin, member, guest), invitations by email or link, and verified email domains that let colleagues join. Anyone who is not a member gets 404 for everything about a workspace.

## Operations (44)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/me/people` | People in my workspaces |
| GET | `/v1/workspaces` | Your workspaces |
| POST | `/v1/workspaces` | Create a workspace |
| GET | `/v1/workspaces/{workspace_id}` | Get a workspace |
| PATCH | `/v1/workspaces/{workspace_id}` | Change a workspace |
| DELETE | `/v1/workspaces/{workspace_id}` | Delete a workspace |
| GET | `/v1/workspaces/{workspace_id}/members` | Members |
| GET | `/v1/workspaces/{workspace_id}/members/{user_id}/export` | Download a member's personal vaults |
| POST | `/v1/workspaces/{workspace_id}/members/{user_id}/delete-account` | Delete a member's account |
| PATCH | `/v1/workspaces/{workspace_id}/members/{user_id}` | Change a member's role |
| DELETE | `/v1/workspaces/{workspace_id}/members/{user_id}` | Remove a member |
| POST | `/v1/workspaces/{workspace_id}/transfer` | Transfer ownership |
| POST | `/v1/workspaces/{workspace_id}/leave` | Leave a workspace |
| POST | `/v1/workspaces/{workspace_id}/join` | Join through your email domain (retired) |
| GET | `/v1/workspaces/{workspace_id}/invitations` | Pending invitations |
| POST | `/v1/workspaces/{workspace_id}/invitations` | Invite someone |
| DELETE | `/v1/workspaces/{workspace_id}/invitations/{invitation_id}` | Revoke an invitation |
| GET | `/v1/workspaces/{workspace_id}/domains` | Claimed email domains |
| POST | `/v1/workspaces/{workspace_id}/domains` | Claim an email domain |
| DELETE | `/v1/workspaces/{workspace_id}/domains/{domain}` | Drop a claimed domain |
| POST | `/v1/workspaces/{workspace_id}/domains/{domain}/verify` | Verify a domain |
| GET | `/v1/me/joinable-workspaces` | Workspaces you can join (retired) |
| POST | `/v1/invitations/preview` | What an invitation is for |
| POST | `/v1/invitations/accept` | Accept an invitation |
| GET | `/v1/workspaces/{workspace_id}/groups` | Groups |
| POST | `/v1/workspaces/{workspace_id}/groups` | Create a group |
| PATCH | `/v1/workspaces/{workspace_id}/groups/{group_id}` | Rename a group |
| DELETE | `/v1/workspaces/{workspace_id}/groups/{group_id}` | Delete a group |
| GET | `/v1/workspaces/{workspace_id}/groups/{group_id}/members` | A group's members |
| POST | `/v1/workspaces/{workspace_id}/groups/{group_id}/members` | Add a member to a group |
| DELETE | `/v1/workspaces/{workspace_id}/groups/{group_id}/members/{user_id}` | Remove a member from a group |
| GET | `/v1/workspaces/{workspace_id}/audit` | The workspace's audit log |
| GET | `/v1/workspaces/{workspace_id}/audit/export` | Download the audit log |
| GET | `/v1/workspaces/{workspace_id}/sso` | The workspace's single sign-on connection |
| PUT | `/v1/workspaces/{workspace_id}/sso` | Connect an identity provider (OpenID Connect or SAML 2.0) |
| DELETE | `/v1/workspaces/{workspace_id}/sso` | Remove single sign-on |
| GET | `/v1/workspaces/{workspace_id}/scim` | The workspace's SCIM provisioning |
| POST | `/v1/workspaces/{workspace_id}/scim/token` | Create or replace the SCIM token |
| DELETE | `/v1/workspaces/{workspace_id}/scim/token` | Turn SCIM provisioning off |
| GET | `/v1/workspaces/{workspace_id}/policy` | The workspace's security policy |
| PUT | `/v1/workspaces/{workspace_id}/policy` | Change the workspace's security policy |
| GET | `/v1/workspaces/{workspace_id}/audit/stream` | Where audit events are streamed |
| PUT | `/v1/workspaces/{workspace_id}/audit/stream` | Stream audit events to an endpoint |
| DELETE | `/v1/workspaces/{workspace_id}/audit/stream` | Stop streaming audit events |

## Machine-readable artifacts (2)

- **OpenAPI** — https://artifacts.apis.io/granite-md/openapi/granite-md-workspaces-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/granite-md/json-schema/granite-md-ssoconnection-schema.json

## Other Granite APIs (12)

- [Granite Auth API](https://apis.io/apis/granite-md/granite-md-auth-api/)
- [Granite Billing API](https://apis.io/apis/granite-md/granite-md-billing-api/)
- [Granite Comments API](https://apis.io/apis/granite-md/granite-md-comments-api/)
- [Granite Drive API](https://apis.io/apis/granite-md/granite-md-drive-api/)
- [Granite Folders API](https://apis.io/apis/granite-md/granite-md-folders-api/)
- [Granite knowledge base API](https://apis.io/apis/granite-md/granite-md-knowledge-base-api/)
- [Granite Me API](https://apis.io/apis/granite-md/granite-md-me-api/)
- [Granite Meta API](https://apis.io/apis/granite-md/granite-md-meta-api/)
- [Granite Note Shares API](https://apis.io/apis/granite-md/granite-md-note-shares-api/)
- [Granite Notes API](https://apis.io/apis/granite-md/granite-md-notes-api/)
- [Granite OAuth API](https://apis.io/apis/granite-md/granite-md-oauth-api/)
- [Granite Publish API](https://apis.io/apis/granite-md/granite-md-publish-api/)

## Tags

Workspace

---

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