Skip to content

Commit

Permalink
Document workspace-name length restriction
Browse files Browse the repository at this point in the history
  • Loading branch information
jirik committed Jan 8, 2024
1 parent f59ac5e commit 191c0d0
Show file tree
Hide file tree
Showing 2 changed files with 3 additions and 2 deletions.
3 changes: 2 additions & 1 deletion doc/models.md
Original file line number Diff line number Diff line change
Expand Up @@ -73,7 +73,7 @@

## Username
- Username is a string identifying one [user](#user), so it is unique among all users.
- The string is lower-case (in contrast with [role name](#role)).
- The string is lower-case (in contrast with [role name](#role)), maximum length is 59 characters.
- Each user is represented by max. one username.
- Username is also used to identify user's [personal workspace](#personal-workspace) when communicating with [Layman REST API](rest.md).
- Username can be reserved by [PATCH Current User](rest.md#patch-current-user).
Expand All @@ -92,6 +92,7 @@
## Workspace
- Workspace is folder for [publications](#publication).
- Each workspace is identified by name that is unique among all workspaces.
- The name is lower-case, maximum length is 59 characters.
- Workspace name is sometimes used for structuring publication-related data. For example, it's part of REST API URL (`/rest/workspaces/<workspace_name>/...`), directory names (`<LAYMAN_DATA_DIR>/workspaces/<workspace_name>/...`), DB schemas, or OGC Web Services (`/geoserver/<workspace_name>/...`, `/geoserver/<workspace_name>_wms/...`).
- Workspace's REST API consists of all [map and layer endpoints](rest.md) endpoints.
- There are following types of workspaces:
Expand Down
2 changes: 1 addition & 1 deletion doc/rest.md
Original file line number Diff line number Diff line change
Expand Up @@ -834,7 +834,7 @@ Query parameters:
- `true`: If `username` sent in body parameter is already reserved by another user or `username` is an empty string, layman will definitely reserve some `username`, preferably similar to the value sent in `username` body parameter or to one of claims.

Body parameters:
- *username*: String. [Username](models.md#username) that should be reserved for current user. Username can be reserved only once and it cannot be changed. See URL parameter `adjust_username` for other details.
- *username*: String. [Username](models.md#username) that should be reserved for current user (maximum length is 59 characters). Username can be reserved only once and cannot be changed. See URL parameter `adjust_username` for other details.

#### Response
Content-Type: `application/json`
Expand Down

0 comments on commit 191c0d0

Please sign in to comment.