Skip to main content

Create a membership

Creates a folder membership for the specified user.

Parameters

user
string
required
ID of the user.
role
enum
required
The role. One of folder_admin, folder_manager, folder_creator, folder_commenter, folder_uploader, folder_viewer.
notification
string
The message to be sent to the user. If omitted, no notification will be sent.

Returns

Returns the added label object. Throws an error if some parameters are not valid.

post
/api/folders/{id}/memberships
curl -X POST https://{workspace}.kitchen.co/api/folders/{id}/memberships \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'X-Requested-With: XMLHttpRequest' \
-H 'Authorization: Bearer {API_KEY}'
Response
{
"id": "nms_99fd10deda4c58d31ab7a1fb",
"user": {
"created_at": "2024-03-11T15:37:23+00:00",
"email": "john.doe@example.net",
"group": "client",
"id": "u_c01bb6102b6ddadd4b1f020e",
"language": null,
"name": "John Doe",
"phone": null,
"role": "member",
"timezone": null,
"title": null,
"updated_at": "2024-03-11T15:37:23+00:00",
"username": "johndoe"
},
"role": "folder_viewer"
}