Workspaces

A workspace is a grouping of data stores. Similar to a namespace, it is used to group data that is related in some way.

/workspaces[.<format>]

Controls all workspaces.

Method	Action	Status code	Formats	Default Format
GET	List all workspaces	200	HTML, XML, JSON	HTML
POST	Create a new workspace	201 with Location header	XML, JSON
PUT		405
DELETE		405

/workspaces/<ws>[.<format>]

Controls a specific workspace.

Method	Action	Status code	Formats	Default Format	Parameters
GET	Return workspace ws	200	HTML, XML, JSON	HTML	quietOnNotFound
POST		405
PUT	200	Modify workspace ws	XML, JSON
DELETE	200	Delete workspace ws	XML, JSON		recurse

Exceptions

Exception	Status code
GET for a workspace that does not exist	404
PUT that changes name of workspace	403
DELETE against a workspace that is non-empty	403

Parameters

recurse

The recurse parameter recursively deletes all layers referenced by the specified workspace, including data stores, coverage stores, feature types, and so on. Allowed values for this parameter are "true" or "false". The default value is "false".

quietOnNotFound

The quietOnNotFound parameter avoids to log an Exception when the Workspace is not present. Note that 404 status code will be returned anyway.

/workspaces/default[.<format>]

Controls the default workspace.

Method	Action	Status code	Formats	Default Format
GET	Returns default workspace	200	HTML, XML, JSON	HTML
POST		405
PUT	200	Set default workspace	XML, JSON
DELETE		405

/workspaces/<ws>/settings[.<format>]

Controls settings on a specific workspace.

Method	Action	Status code	Formats	Default Format
GET	Returns workspace settings	200	HTML, XML, JSON	HTML
POST		405
PUT	Creates or updates workspace settings	200	XML, JSON
DELETE	Deletes workspace settings	200	XML, JSON