Sign in
Manage permissions

Changed on

Assign multiple permissions at once

  • Can put both regular and partial permission in the payload
post/api/v2/assets/{uid_asset}/permission-assignments/bulk/

Request

  • The document declares no server URL.
  • Auth: one of:
    • HTTP basic
    • API key in header Authorization

Path parameters

uid_assetstring required

UID of the parent asset

Request body

userstring uri required
permissionstring uri required

Example request

[
  {
    "user": "https://kf.kobotoolbox.org/api/v2/users/bob/",
    "permission": "https://kf.kobotoolbox.org/api/v2/assets/a3C9wWefqZVkChNLKqqXVZ/permission-assignments/pGaXCTDAbdZKLXoXAXd3M4/"
  }
]

Response

urlstring uri required
userstring uri required
permissionstring uri required
labelstring required

Example response

[
  {
    "url": "https://kf.kobotoolbox.org/api/v2/assets/a3C9wWefqZVkChNLKqqXVZ/permission-assignments/pGaXCTDAbdZKLXoXAXd3M4/",
    "user": "https://kf.kobotoolbox.org/api/v2/users/bob/",
    "permission": "https://kf.kobotoolbox.org/api/v2/permissions/change_asset/"
  }
]

Changes