Sign in
Manage permissions

Changed on

Assign a permission

N.B.:

  • Filters use Mongo Query Engine to narrow down results
  • Filters are joined with OR operator
  • Implied permissions will be also assigned. (e.g. change_asset will add view_asset too)
post/api/v2/assets/{uid_asset}/permission-assignments/

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

OR

Example request

{
  "permission": "https://kf.kobotoolbox.org/api/v2/permissions/change_asset/",
  "user": "https://kf.kobotoolbox.org/api/v2/users/bob/"
}

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