POSTapi.synup.com/api/v4/users/folders/add

Add folders to user

This API associates one or more folders with a specified user, granting them access to manage those folders.

Behavior:

Supports assigning multiple folders to a single user.
Updates the user's permissions based on assigned folders.

Requires an API key. Send it as Authorization: API <your-key> — see Getting started.

Parameters

Body

Name	Type	Required	Description
`input`	object	optional
`input.userId`	string	required	Base64 encoded user ID
`input.folderIds`	array of string	required	Array of folder UUIDs to associate with the user
`input.defaultFolderId`	string	required

Request

curl -X POST 'https://api.synup.com/api/v4/users/folders/add' \
  -H 'Authorization: API YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "input": {
    "userId": "VXNlcjoxMDAyOA==",
    "folderIds": [
      "c1d92c09-8ddd-469e-af96-0eb64a48d647",
      "a5af4f5d-41b6-4a8a-b24f-98741b021b7b"
    ],
    "defaultFolderId": "c1d92c09-8ddd-469e-af96-0eb64a48d647"
  }
}'

const res = await fetch('https://api.synup.com/api/v4/users/folders/add', {
  method: 'POST',
  headers: {
    Authorization: 'API YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "input": {
      "userId": "VXNlcjoxMDAyOA==",
      "folderIds": [
        "c1d92c09-8ddd-469e-af96-0eb64a48d647",
        "a5af4f5d-41b6-4a8a-b24f-98741b021b7b"
      ],
      "defaultFolderId": "c1d92c09-8ddd-469e-af96-0eb64a48d647"
    }
  }),
});
const data = await res.json();

import requests
res = requests.post(
    "https://api.synup.com/api/v4/users/folders/add",
    headers={
        "Authorization": "API YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json={
      "input": {
        "userId": "VXNlcjoxMDAyOA==",
        "folderIds": [
          "c1d92c09-8ddd-469e-af96-0eb64a48d647",
          "a5af4f5d-41b6-4a8a-b24f-98741b021b7b"
        ],
        "defaultFolderId": "c1d92c09-8ddd-469e-af96-0eb64a48d647"
      }
    },
)
data = res.json()

req, _ := http.NewRequest("POST", "https://api.synup.com/api/v4/users/folders/add", bytes.NewBufferString(payload))
req.Header.Set("Authorization", "API YOUR_API_KEY")
req.Header.Set("Content-Type", "application/json")

res, err := http.DefaultClient.Do(req)

Responses

Status	Description
`200`	Successfully added folders to user

Example response (generated from the schema)

{
  "data": {
    "addFoldersForUser": {
      "status": [
        {
          "errors": [
            "string"
          ],
          "folderId": "00000000-0000-0000-0000-000000000000",
          "success": true
        }
      ]
    }
  }
}

Response body

Name	Type	Required
`data`	object	optional
`data.addFoldersForUser`	object	optional
`data.addFoldersForUser.status`	array of object	optional
`data.addFoldersForUser.status[].errors`	array of string	optional
`data.addFoldersForUser.status[].folderId`	string	optional
`data.addFoldersForUser.status[].success`	boolean	optional