Manage projects and library content

Changed on

Create (send) an invite

Where the assets uid are given in the payload's list

post/api/v2/project-ownership/invites/

Request

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

Request body

recipientstring uri required
assetsstring[] required

Example request

{
  "recipient": "https://kf.kobotoolbox.org/api/v2/users/bob/"
}

Response

urlstring uri required
sender | recipientstring uri required
status'accepted' | 'cancelled' | 'declined' | 'expired' | 'pending' | 'resent' required
  • accepted - Accepted
  • cancelled - Cancelled
  • declined - Declined
  • expired - Expired
  • pending - Pending
  • resent - Resent
date_createdstring date-time required
date_modifiedstring date-time required

Example response

{
  "url": "https://kf.kobotoolbox.org/api/v2/project-ownership/invites/poi52fGkwDjQeZkUxcaou39q/",
  "sender |  recipient": "https://kf.kobotoolbox.org/api/v2/users/bob/",
  "transfers": [
    {
      "url": "https://kf.kobotoolbox.org/api/v2/project-ownership/invites/poi52fGkwDjQeZkUxcaou39q/transfers/pot54pTqM5qwKdZ4wnNdiwDY/",
      "asset": "https://kf.kobotoolbox.org/api/v2/assets/a3C9wWefqZVkChNLKqqXVZ/"
    }
  ]
}

Changes