For the complete documentation index, see llms.txt. This page is also available as Markdown.

Organization | Groups

Retrieve a list of groups of your organization tenant.

get
Authorizations
X-API-KEYstringRequired

Required for authorization in every request. You can request an API-Key for your tenant in the integrations section of the equipme App.

Query parameters
categoriesstring[]Optional

Filter by one or multiple specific group categories

companyNamesstring[]Optional

Filter by one or multiple company names related to the group

sortBystring · enumOptional

Parameters according to which groups can be sorted.

Possible values:
sortOrderstring · enumOptional

Order in which the result of a list request is sorted.

Possible values:
offsetinteger · int32Optional

Specifies the index of the first item to return

Default: 0
limitinteger · int32Optional

Specifies the maximum number of items to return (min: 1; max: 1000)

Default: 100
Responses
200

OK: The requested groups.

application/json
totalinteger · int32Required
get/v1/organization/groups

Create a group.

post
Authorizations
X-API-KEYstringRequired

Required for authorization in every request. You can request an API-Key for your tenant in the integrations section of the equipme App.

Body
typestring · enumRequired

Type of the group.

Possible values:
namestring · max: 100Required

The name of the group.

Example: Project 1337
categorystring · max: 50 · nullableOptional

A customizable category of the group. Can be used to categorize groups independent from the group type.

Example: Projects 2024
companyNamestring · max: 100 · nullableOptional

A customizable company name of the group. Can be used to distinguish same departments between different sub companies of the tenant.

Example: Projects 2024
descriptionstring · max: 500 · nullableOptional

The description of the group.

Example: The team is responsible for customer inquiries.
emailstring · max: 100 · nullableOptional

The email of the group.

Example: group.mailbox@company.comPattern: ^[a-zA-Z0-9.!#$%&’*+/=?^_`{|}~-]+@[a-zA-Z0-9-]+(?:\.[a-zA-Z0-9-]+)*\.[a-zA-Z]{2,}$
Responses
201

Created: The created group.

application/json
typestring · enumOptional

Type of the group.

Possible values:
categorystring · nullableOptional

A customizable category of the group. Can be used to categorize groups independent from the group type.

Example: Projects 2024
companyNamestring · max: 100 · nullableOptional

A customizable company name of the group. Can be used to distinguish same departments between different sub companies of the tenant.

Example: Projects 2024
descriptionstring · nullableOptional

The description of the group.

Example: Project start: 2024/04/01
emailstring · nullableOptional

The email address of the group.

Example: group.mailbox@company.com
tagsstring[] · nullableOptional

Assigned tags

idinteger · int32Required

The id to identify the group in the system.

Example: 42
namestring · max: 50Required

The name of the group.

Example: Project 1337
post/v1/organization/groups

Retrieve a single group by its id.

get
Authorizations
X-API-KEYstringRequired

Required for authorization in every request. You can request an API-Key for your tenant in the integrations section of the equipme App.

Path parameters
groupIdinteger · int32Required

The identifier of the group.

Responses
200

OK: The requested group.

application/json
typestring · enumOptional

Type of the group.

Possible values:
categorystring · nullableOptional

A customizable category of the group. Can be used to categorize groups independent from the group type.

Example: Projects 2024
companyNamestring · max: 100 · nullableOptional

A customizable company name of the group. Can be used to distinguish same departments between different sub companies of the tenant.

Example: Projects 2024
descriptionstring · nullableOptional

The description of the group.

Example: Project start: 2024/04/01
emailstring · nullableOptional

The email address of the group.

Example: group.mailbox@company.com
tagsstring[] · nullableOptional

Assigned tags

idinteger · int32Required

The id to identify the group in the system.

Example: 42
namestring · max: 50Required

The name of the group.

Example: Project 1337
get/v1/organization/groups/{groupId}

Update an existing group.

put

Overwrites all existing data with that from the request body.

Authorizations
X-API-KEYstringRequired

Required for authorization in every request. You can request an API-Key for your tenant in the integrations section of the equipme App.

Path parameters
groupIdinteger · int32Required

The identifier of the group to be updated.

Body
namestring · max: 100Required

The name of the group.

Example: Project 1337
categorystring · max: 50 · nullableOptional

A customizable category of the group. Can be used to categorize groups independent from the group type.

Example: Projects 2024
companyNamestring · max: 100 · nullableOptional

A customizable company name of the group. Can be used to distinguish same departments between different sub companies of the tenant.

Example: Projects 2024
descriptionstring · max: 500 · nullableOptional

The description of the group.

Example: The team is responsible for customer inquiries.
emailstring · max: 100 · nullableOptional

The email of the group.

Example: group.mailbox@company.comPattern: ^[a-zA-Z0-9.!#$%&’*+/=?^_`{|}~-]+@[a-zA-Z0-9-]+(?:\.[a-zA-Z0-9-]+)*\.[a-zA-Z]{2,}$
Responses
204

NoContent: Request has succeeded.

No content

put/v1/organization/groups/{groupId}

No content

Delete a group.

delete
Authorizations
X-API-KEYstringRequired

Required for authorization in every request. You can request an API-Key for your tenant in the integrations section of the equipme App.

Path parameters
groupIdinteger · int32Required

The identifier of the group to be deleted.

Responses
204

NoContent: Request has succeeded.

No content

delete/v1/organization/groups/{groupId}

No content

Retrieve the members of a group.

get
Authorizations
X-API-KEYstringRequired

Required for authorization in every request. You can request an API-Key for your tenant in the integrations section of the equipme App.

Path parameters
groupIdinteger · int32Required

The identifier of the group.

Query parameters
sortBystring · enumOptional

Parameters according to which an employee can be sorted.

Possible values:
sortOrderstring · enumOptional

Order in which the result of a list request is sorted.

Possible values:
offsetinteger · int32Optional

Specifies the index of the first item to return

Default: 0
limitinteger · int32Optional

Specifies the maximum number of items to return (min: 1; max: 1000)

Default: 100
Responses
200

OK: The requested group members.

application/json
totalinteger · int32Required
get/v1/organization/groups/{groupId}/members

Add group members.

post
Authorizations
X-API-KEYstringRequired

Required for authorization in every request. You can request an API-Key for your tenant in the integrations section of the equipme App.

Path parameters
groupIdinteger · int32Required

The identifier of the group to which new members are to be added.

Bodyobject · GroupMemberReference[]
idinteger · int32Optional

The id of the group member.

Example: 132
Responses
204

NoContent: Request has succeeded.

No content

post/v1/organization/groups/{groupId}/members

No content

Delete group members.

delete
Authorizations
X-API-KEYstringRequired

Required for authorization in every request. You can request an API-Key for your tenant in the integrations section of the equipme App.

Path parameters
groupIdinteger · int32Required

The identifier of the group whose members are to be deleted.

Bodyobject · GroupMemberReference[]
idinteger · int32Optional

The id of the group member.

Example: 132
Responses
204

NoContent: Request has succeeded.

No content

delete/v1/organization/groups/{groupId}/members

No content

Get all metadata items for a given organizational-group

get
Authorizations
X-API-KEYstringRequired

Required for authorization in every request. You can request an API-Key for your tenant in the integrations section of the equipme App.

Path parameters
groupIdinteger · int32Required
Responses
200

Ok

application/json
totalinteger · int32Required
get/v1/organization/groups/{groupId}/metadata

Create a metadata entry for a organizational-group

post
Authorizations
X-API-KEYstringRequired

Required for authorization in every request. You can request an API-Key for your tenant in the integrations section of the equipme App.

Path parameters
groupIdinteger · int32Required

The identifier of the group for which the metadata entry is to be created.

Body

DTO for creating a new metadata entry for a given resource which implements the logic

keystring · max: 150 · nullableOptional

Key for the new metadata entry

valuestring · max: 500 · nullableOptional

Metadata value

Responses
201

Created: The created metadata entry.

application/json
valuestring · max: 500 · nullableOptional

Metadata value

Example: EQ1337555
scopestring · nullableOptional

Metadata scope. Can be Customer or Supplier to indicate the metadata is specific to a customer or supplier.

Example: Supplier
keystring · max: 150Required

Metadata key used as a unique identifier for the metadata item.

Example: ExternalSystemId
post/v1/organization/groups/{groupId}/metadata

Get a single metadata item of a given organizational-group

get
Authorizations
X-API-KEYstringRequired

Required for authorization in every request. You can request an API-Key for your tenant in the integrations section of the equipme App.

Path parameters
groupIdinteger · int32Required

The unique identifier for the target organization unit

keystringRequired

The metadata key

Responses
200

Ok

application/json
valuestring · max: 500 · nullableOptional

Metadata value

Example: EQ1337555
scopestring · nullableOptional

Metadata scope. Can be Customer or Supplier to indicate the metadata is specific to a customer or supplier.

Example: Supplier
keystring · max: 150Required

Metadata key used as a unique identifier for the metadata item.

Example: ExternalSystemId
get/v1/organization/groups/{groupId}/metadata/{key}

Delete a single metadata item for a given organizational-group

delete
Authorizations
X-API-KEYstringRequired

Required for authorization in every request. You can request an API-Key for your tenant in the integrations section of the equipme App.

Path parameters
groupIdinteger · int32Required
keystringRequired
Responses
204

No Content

No content

delete/v1/organization/groups/{groupId}/metadata/{key}

No content

Retrieve the service instances of a group.

get
Authorizations
X-API-KEYstringRequired

Required for authorization in every request. You can request an API-Key for your tenant in the integrations section of the equipme App.

Path parameters
groupIdinteger · int32Required

The identifier of the group.

Query parameters
servicesinteger · int32[]Optional

Filter by one or multiple specific services of your portfolio

statusesstring[]Optional

Filter by one or multiple specific statuses

activebooleanOptional

Filter the instances which are active or not active. When null, all instances will be returned. Default: null

subscriptionPeriodRenewalsinteger · int32[]Optional

Filter by one or multiple specific values for the period renewal, e.g. to filter all without a renewal use 0

modifiedSincestring · date-timeOptional

Filter the instances modified after the specified date. A modification is identified when: the assignment changed, the instance got activated, the instance got cancelled

expiresAfterstring · date-timeOptional

Filter the instances which expire after this date

expiresBeforestring · date-timeOptional

Filter the instances which expire before this date

searchstringOptional

Filter for id, service name, inventory number, employee first and last name, group, location name or metadata values

sortBystring · enumOptional

Sort the items by a given criterion.

Possible values:
sortOrderstring · enumOptional

Order in which the result of a list request is sorted.

Possible values:
offsetinteger · int32Optional

Specifies the index of the first item to return

Default: 0
limitinteger · int32Optional

Specifies the maximum number of items to return (min: 1; max: 1000)

Default: 100
Responses
200

OK: The requested service instances of a group.

application/json
totalinteger · int32Required
get/v1/organization/groups/{groupId}/service-instances

Add service instances to a group.

post
Authorizations
X-API-KEYstringRequired

Required for authorization in every request. You can request an API-Key for your tenant in the integrations section of the equipme App.

Path parameters
groupIdinteger · int32Required

The identifier of the group to which new service instances are to be added.

Bodyobject · GroupServiceInstanceReference[]
idinteger · int32 · min: 1 · max: 2147483647Required

The id of the service instance.

Example: 28
Responses
204

NoContent: Request has succeeded.

No content

post/v1/organization/groups/{groupId}/service-instances

No content

Delete service instances from a group.

delete
Authorizations
X-API-KEYstringRequired

Required for authorization in every request. You can request an API-Key for your tenant in the integrations section of the equipme App.

Path parameters
groupIdinteger · int32Required

The identifier of the group from which the service instances are to be deleted.

Bodyobject · GroupServiceInstanceReference[]
idinteger · int32 · min: 1 · max: 2147483647Required

The id of the service instance.

Example: 28
Responses
204

NoContent: Request has succeeded.

No content

delete/v1/organization/groups/{groupId}/service-instances

No content

Last updated

Was this helpful?