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

Folders

/api/helpdesk/forms/folders/{folderId}/members

Exposes HelpDesk form folders as a hierarchical WebAPI resource.

GET /api/helpdesk/forms/folders returns the protected root node with compact summaries of its direct forms and one shallow level of child summaries. Resolve a child folder for its direct contents; descendants are never embedded recursively. Individual folders support normal create, update, and delete operations. New folders default to FolderSharingMode#PRIVATE. A normal delete is deliberately limited to empty folders; recursive deletion is an explicit confirmation-protected tree action. Read-only identifiers are accepted and ignored when a GET representation is sent back unchanged.

GET /api/helpdesk/forms/folders/{folderId}/members

Explicit users and groups for RESTRICTED sharing.

Parameters

Name Location Type Required Description
folderId path string yes folder identifier from the URL

Response

Status Content Type Schema Description
200 application/json array<FolderSharingMember> Successful response.

Example Request

# Request
GET /api/helpdesk/forms/folders/<folderId>/members HTTP/1.1
Accept: application/json
Authorization: Bearer <access-token>

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

[
    {
        "id": "835qzosebu9m2fejkykc228mu",
        "type": "group"
    }
]

PUT /api/helpdesk/forms/folders/{folderId}/members

Explicit users and groups for RESTRICTED sharing.

Parameters

Name Location Type Required Description
folderId path string yes folder identifier from the URL

Request Body

Content Type Schema Required Description
application/json array<FolderSharingMember> yes

Explicit users and groups for RESTRICTED sharing.

Response

Status Content Type Schema Description
200 application/json array<FolderSharingMember> Successful response.

Example Request

# Request
PUT /api/helpdesk/forms/folders/<folderId>/members HTTP/1.1
Accept: application/json
Authorization: Bearer <access-token>
Content-Type: application/json

[
    {
        "id": "835qzosebu9m2fejkykc228mu",
        "type": "group"
    }
]

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

[
    {
        "id": "835qzosebu9m2fejkykc228mu",
        "type": "group"
    }
]

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.

FolderSharingMember

Property Type Required Description
id string no —
type string [group, user] no —

ApiError

Property Type Required Description
status integer (int32) yes —
code string yes —
message string yes —
details array<object> no —
i-net HelpDesk
This application uses cookies to allow login. By continuing to use this application, you agree to the use of cookies.


Help