GitBook

GitBook is a platform for creating, maintaining, and sharing documentation, allowing teams to collaborate on content development and version control. It is used to create easily accessible and up-to-date documentation for projects or products.

Data Model

• Organizations — top-level containers; spaces and content live under an organization.
• Users — account users across the organization.
• Spaces — documentation spaces (projects) belonging to an organization.
• Content — pages and structure within a space; hierarchical.
• Insights Traffic — page view and traffic analytics per space.
• Org Members — users with access to an organization.

Gotchas

• Space-first: Content and insights are scoped to a space; list spaces from the organization first.
• Content hierarchy: Content uses a tree structure; parent/child relationships matter for navigation.
• Revision history: Content changes may have separate revision endpoints; check API for history.