Skip to content

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