{{sidenavigation.sidenavigationExpandLabel}}
{{getMsg('Help_YouAreHere')}}: /  {{page.title}} {{page.title}}
{{$root.getMsg("downLoadHelpAsPdf")}} {{helpModel.downloadHelpPdfDataStatus}}

Groups

/api/usersandgroups/groups/{groupId}/fields/{fieldKey}

Exposes groups through the annotation-based WebAPI.

The collection operation deliberately returns compact summaries. A model operation returns only fields whose registered GroupFieldDefinition grants access to the current caller. All mutations are staged on this request-local object and are validated before the first manager write.

For an existing group, both PUT and PATCH use partial-update semantics: only properties supplied by the request are changed, while omitted properties retain their current values. PUT is not a full replacement.

GET /api/usersandgroups/groups/{groupId}/fields/{fieldKey}

Returns one registered field value. This dynamic property is also used by PATCH bodies containing a field key directly.

Parameters

Name Location Type Required Description
groupId path string yes group identifier from the URL
fieldKey path string yes registered field key

Response

Status Content Type Schema Description
200 application/json Object field value, or null when it is not present

Example Request

# Request
GET /api/usersandgroups/groups/<groupId>/fields/<fieldKey> HTTP/1.1
Accept: application/json
Authorization: Bearer <access-token>

# Response
HTTP/1.1 200 OK
Content-Type: application/json

{
    
}

PUT /api/usersandgroups/groups/{groupId}/fields/{fieldKey}

Stages one registered group field value. Conversion and validation are delegated to the installed GroupFieldDefinition.

Parameters

Name Location Type Required Description
groupId path string yes group identifier from the URL
fieldKey path string yes registered field key

Request Body

Content Type Schema Required Description
application/json Object yes new field value

Response

Status Content Type Schema Description
200 application/json Object Successful response.

Example Request

# Request
PUT /api/usersandgroups/groups/<groupId>/fields/<fieldKey> HTTP/1.1
Accept: application/json
Authorization: Bearer <access-token>
Content-Type: application/json

{
    
}

# Response
HTTP/1.1 200 OK
Content-Type: application/json

{
    
}

Common Error Responses

The status codes 400, 403, 404, 405, 406, 409, 413, 415, and 500 use the same ApiError JSON error format:

{
    "status": 404,
    "code": "route_not_found",
    "message": "The requested API route does not exist.",
    "details": []
}

Schemas

Request and response schemas used on this page.

Object

Type: object

ApiError

Property Type Required Description
status integer (int32) yes —
code string yes —
message string yes —
details array<object> no —
i-net PDFC
Diese Anwendung verwendet Cookies um das Einloggen zu ermöglichen. Durch die weitere Nutzung dieser Anwendung stimmen Sie der Verwendung von Cookies zu.


Hilfe