Update

PUT

/{organization}/projects/{projectId}/groups/{groupId}

const url = 'https://app.civillo.com/api/v1/example/projects/1/groups/1';
const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"name":"My group","color":"#6200EE","hidden":false,"isWorkOrderAssignable":true,"managedByRole":false,"roles":[1,4,16],"created":"2026-04-15T12:00:00Z"}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request PUT \
  --url https://app.civillo.com/api/v1/example/projects/1/groups/1 \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "name": "My group", "color": "#6200EE", "hidden": false, "isWorkOrderAssignable": true, "managedByRole": false, "roles": [ 1, 4, 16 ], "created": "2026-04-15T12:00:00Z" }'

Update a group.

Authorizations

bearerAuth
Project admin

Parameters

Path Parameters

organization

required

string

The organization nickname

projectId

required

integer

The project id

groupId

required

integer

The group id

Request Body

The layer ids to be added to the

application/json

object

poiTagRestrictions

Group users will be restricted to viewing points of interest with these tags.

Array<string>

Example

[
  "some",
  "random",
  "tags"
]

name

The name of this group.

string

>= 2 characters <= 64 characters

Example

My group

color

The color this group is displayed with.

string

>= 7 characters <= 9 characters

Example

#6200EE

hidden

If true, the group will not be displayed next to users’ names.

boolean

Example

false

isWorkOrderAssignable

If true, allow work orders to be assigned to this group.

boolean

Example

true

managedByRole

If set to true, non-admins with the GroupManagement group role will be able to see and manage this group via the admin group management page.

Note that selecting this option and adding a role to this group will result in such non-admins being able to add any other project users to this group, hereby granting them this role.

Ensure you are aware of these permissions implications before configuring this group as such.

boolean

Example

false

roles

Array of integer-enumerated group roles to be assigned to the group (see Create endpoint description).

Array<integer>

Example

[
  1,
  4,
  16
]

created

The time at which the group was created.

string format: date-time

Responses

200

Successful response

application/json

object

layerIds

An array of layer IDs associated with this group.

Array<integer>

userIds

An array of public user IDs associated with this group.

Array<string>

The unique identifier for this group.

integer

poiTagRestrictions

Group users will be restricted to viewing points of interest with these tags.

Array<string>

name

The name of this group.

string

>= 2 characters <= 64 characters

color

The color this group is displayed with.

string

>= 7 characters <= 9 characters

hidden

If true, the group will not be displayed next to users’ names.

boolean

isWorkOrderAssignable

If true, allow work orders to be assigned to this group.

boolean

managedByRole

boolean

roles

Array of integer-enumerated group roles to be assigned to the group (see Create endpoint description).

Array<integer>

created

The time at which the group was created.

string format: date-time

Example

{
  "name": "My group",
  "color": "#6200EE",
  "hidden": false,
  "isWorkOrderAssignable": true,
  "managedByRole": false,
  "roles": [
    1,
    4,
    16
  ]
}

400

Bad Request

401

Unauthorized

403

Forbidden