# GitBook Critical API

**Canonical:** https://apis.io/apis/gitbook/gitbook-critical-api/  
**Provider:** GitBook — https://apis.io/providers/gitbook/  
**Documentation:** https://docs.gitbook.com/developers

GitBook Critical API is one of 65 APIs that [GitBook](https://apis.io/providers/gitbook/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification. This API exposes 7 JSON Schema definitions. Tagged areas include critical. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an AsyncAPI specification, a JSON-LD context, and 7 JSON Schemas.

The critical API from GitBook — 12 operation(s) for critical.

## Operations (13)

| Method | Path | Summary |
|---|---|---|
| GET | `/user` | Get profile of authenticated user |
| GET | `/users/{userId}` | Get a user by its ID |
| PATCH | `/users/{userId}` | Update a user by its ID |
| GET | `/spaces/{spaceId}` | Get full details of a space by its ID |
| GET | `/spaces/{spaceId}/comments` | List all top-level comments posted on a space |
| GET | `/spaces/{spaceId}/commenters` | List all users who have posted comments in a space |
| GET | `/spaces/{spaceId}/change-requests/{changeRequestId}/commenters` | List all users who have commented in a change request |
| GET | `/orgs` | Get the list of organizations for the currently authenticated user |
| GET | `/orgs/{organizationId}` | Get an organization by its ID |
| GET | `/orgs/{organizationId}/members/{userId}` | Get an organization member by its ID |
| GET | `/orgs/{organizationId}/integrations/installations-status` | List all integration statuses |
| GET | `/orgs/{organizationId}/sites` | List all documentation sites in an organization |
| GET | `/orgs/{organizationId}/sites/{siteId}/site-spaces` | List all spaces linked to a site as content sources |

## Machine-readable artifacts (11)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/gitbook/refs/heads/main/openapi/gitbook-critical-api-openapi.yml
- **Documentation** — https://docs.gitbook.com/developers
- **AsyncAPI** — https://raw.githubusercontent.com/api-evangelist/gitbook/refs/heads/main/asyncapi/gitbook-gitbook-api-asyncapi.yml
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/gitbook/refs/heads/main/json-schema/organization.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/gitbook/refs/heads/main/json-schema/space.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/gitbook/refs/heads/main/json-schema/page.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/gitbook/refs/heads/main/json-schema/user.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/gitbook/refs/heads/main/json-schema/change-request.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/gitbook/refs/heads/main/json-schema/docs-site.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/gitbook/refs/heads/main/json-schema/collection.json
- **JSONLD** — https://raw.githubusercontent.com/api-evangelist/gitbook/refs/heads/main/json-ld/gitbook-context.jsonld

## Other GitBook APIs (12)

- [GitBook Change Request Content API](https://apis.io/apis/gitbook/gitbook-change-request-content-api/)
- [GitBook Change Request Reviewers API](https://apis.io/apis/gitbook/gitbook-change-request-reviewers-api/)
- [GitBook Change Requests API](https://apis.io/apis/gitbook/gitbook-change-requests-api/)
- [GitBook Collections API](https://apis.io/apis/gitbook/gitbook-collections-api/)
- [GitBook Custom Hostnames API](https://apis.io/apis/gitbook/gitbook-custom-hostnames-api/)
- [GitBook Imports API](https://apis.io/apis/gitbook/gitbook-imports-api/)
- [GitBook Integrations API](https://apis.io/apis/gitbook/gitbook-integrations-api/)
- [GitBook Organization Members API](https://apis.io/apis/gitbook/gitbook-organization-members-api/)
- [GitBook Organizations API](https://apis.io/apis/gitbook/gitbook-organizations-api/)
- [GitBook Site Spaces API](https://apis.io/apis/gitbook/gitbook-site-spaces-api/)
- [GitBook Space Content API](https://apis.io/apis/gitbook/gitbook-space-content-api/)
- [GitBook Spaces API](https://apis.io/apis/gitbook/gitbook-spaces-api/)

## Tags

critical

---

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