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

Previous: Global settings