Changelog
Last updated
Was this helpful?
Last updated
Was this helpful?
Was this helpful?
With the release of Docs sites, certain API endpoints for publishing, share-links, and visitor authentication have been deprecated and may no longer function as expected. If you are affected, we recommend the following approach to make the necessary updates:
To modify or retrieve publishing states, share links, or visitor authentication settings for a Space, locate the associated Site and copy its ID. Click the globe icon at the top of the Space's screen to open the Site, then copy the Site ID from the URL.
PATCH /spaces/{spaceId} to change the visibility or published state of the space now requires the following changes:
PATCH /orgs/{organizationId}/sites/{siteId} to change the visibility of the site.
POST /orgs/{organizationId}/sites/{siteId}/publish in order to publish the site and POST /orgs/{organizationId}/sites/{siteId}/unpublish to unpublish the site.
/spaces/{spaceId}/share-links and /spaces/{spaceId}/share-links/{shareLinkId} now requires you to use /orgs/{organizationId}/sites/{siteId}/share-links and /orgs/{organizationId}/sites/{siteId}/share-links/{shareLinkId}respectively.
/spaces/{spaceId}/publishing/auth methods should now be used through /orgs/{organizationId}/sites/{siteId}/publishing/auth
We have changed the way we compute the feedback score based on user ratings which is affecting the following endpoint: /v1/spaces/:id/insights/content
Note: The GitBook app is displaying ponderedScore inside of the Insights section.
We are introducing a collection of API endpoints to automate the management of members and teams in an organization:
/v1/orgs/:id/members
/v1/orgs/:id/invites
/v1/orgs/:id/teams
Endpoint /v1/owners/:id/spaces has been removed and replaced by:
/v1/orgs/:id/spaces for an organization
/v1/users/:id/spaces for a user
Page previously had only one path property representing the page slug in its direct page parent. Pages will now include 2 properties:
slug: representing the page's slug in its direct parent
path: representing the complete page's path in the revision
Requests on page using a URL will now require a URL encoded page's path. For example the previous request:
should now be:
Previously POST /v1/spaces/:space/change-requests was only returning the ID of the newly created change-request.
The response will now contain the entire change-request object. A property changeRequest is appended for compatibility, but marked as deprecated and will be removed in the near future.
[Updated] score is now calculated this way.
This is done to reinforce negative ratings and help surfacing content that may require updates.
[Updated] rating is now computed this way
'good' whenever the score is > 0
'ok' whenever the score is 0
'bad' whenever the score is < 0
[Added] ponderedScore is computed by multiplying the score by the total amount of ratings given by visitors.