# Workspace Baselines

A Gantt workspace baseline is a snapshot of a workspace at a particular point in time.
The snapshot contains aggregate statistics and certain data about each story (task).

## Fetching a list of Workspace Baselines

 - [GET /workspace_baselines](https://developer.kantata.com/kantata/specification/workspace-baselines/get-workspace-baselines.md): Returns a list of Gantt workspace baselines associated with workspaces (projects) that are visible to the authenticated user.
Visibility restrictions on projects are detailed in the Workspaces API documentation


This endpoint returns structured Workspace Baseline objects.
As with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the results array
and will be indexed by ID in the workspace_baselines top-level JSON key.
Please see our Response Format section for more information.

## Creating a new Workspace Baseline

 - [POST /workspace_baselines](https://developer.kantata.com/kantata/specification/workspace-baselines/create-workspace-baseline.md): Creates a Gantt workspace baseline for a specified workspace (project). The baseline will contain aggregate statistics and certain data about each story (task).


This endpoint returns structured Workspace Baseline objects.
As with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the results array
and will be indexed by ID in the workspace_baselines top-level JSON key.
Please see our Response Format section for more information.

## Fetching a single Workspace Baseline

 - [GET /workspace_baselines/{id}](https://developer.kantata.com/kantata/specification/workspace-baselines/get-workspace-baseline.md): Returns a specified Gantt workspace baseline.


This endpoint returns structured Workspace Baseline objects.
As with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the results array
and will be indexed by ID in the workspace_baselines top-level JSON key.
Please see our Response Format section for more information.

## Updating an existing Workspace Baseline

 - [PUT /workspace_baselines/{id}](https://developer.kantata.com/kantata/specification/workspace-baselines/update-workspace-baseline.md): Updates a specified Gantt workspace baseline.


This endpoint returns structured Workspace Baseline objects.
As with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the results array
and will be indexed by ID in the workspace_baselines top-level JSON key.
Please see our Response Format section for more information.

## Deleting an existing Workspace Baseline

 - [DELETE /workspace_baselines/{id}](https://developer.kantata.com/kantata/specification/workspace-baselines/delete-workspace-baseline.md): The response will contain no content and an HTTP 204 status code if the request was
successful, or a standard Kantata OX error message explaining why the object could not be deleted.