---
title: "Assign Users to Personal Folders"
method: POST
path: "/references/folder/sharedfolder"
tags: ["References"]
---

# Assign Users to Personal Folders

`POST /references/folder/sharedfolder`

Assigns one or more users to existing personal folders, shared folders. Supports both numeric and GUID folder IDs

**Allowed accessLevel: 10 (Read), 20 (Write).**

## Request body

- AssignFolderUserRequest[]
  - `folderId` string, nullable — The folder identifier. Accepts numeric identifiers and GUID-format strings (32 hex characters).
  - `userId` integer — The user to assign or update. Must be greater than zero.
  - `accessLevel` integer — Access level to assign. Accepted values: 10 (Read), 20 (Write). Full access (30) is reserved for the folder owner and cannot be assigned through this endpoint.

## Response `200`

Assignments processed.

- FolderUserAssignedResult[]
  - `folderId` string, nullable — Echo of the folder identifier from the request.
  - `userId` integer — Echo of the user identifier from the request.
  - `success` boolean — Indicates whether the assignment was created or updated successfully.
  - `error` string, nullable — Error description when Success is false. Null when the operation succeeds.

---

[API](https://skmtc.net/researchsolutions/apis/article-galaxy-api.md) · [All operations](https://skmtc.net/researchsolutions/apis/article-galaxy-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/researchsolutions/article-galaxy-api/revisions/70fb92d278f5/schema)