POST /api/v2/drop_folders/:drop_folder_id/guests
Invite guest by email

Headers

Header name	Description
Content-Type required	application/json
X-API-KEY required	YOUR_API_KEY

Params

Param name	Description
email required	Email Validations: Must be a String

Examples

// Successful request
POST /api/v2/drop_folders/19/guests
{
  "email": "example-email@example.com"
}
200
{
  "users": [
    {
      "id": 131,
      "first_name": null,
      "last_name": null,
      "email": "admin-user-112@example.com",
      "user_role": {
        "name": "admin"
      }
    },
    {
      "id": 132,
      "first_name": null,
      "last_name": null,
      "email": "example-email@example.com",
      "user_role": {
        "name": "guest"
      }
    }
  ]
}

// Successful request
POST /api/v2/drop_folders/20/guests
{
  "email": "admin-user-113@example.com"
}
400
{
  "error": "User already exists"
}

// If :drop_folder_id is not found
POST /api/v2/drop_folders/not-found-id/guests
{
  "email": "example-email@example.com"
}
404
{
  "error": "dropfolder not found"
}

// Failed request
POST /api/v2/drop_folders/not-found-id/guests
404
{
  "error": "dropfolder not found"
}

// Successful request
POST /api/v2/drop_folders/48/guests
{
  "email": "testiemail@tvtools.fi"
}
200
{
  "users": [
    {
      "id": 168,
      "first_name": null,
      "last_name": null,
      "email": "admin-user-147@example.com",
      "user_role": {
        "name": "admin"
      }
    },
    {
      "id": 169,
      "first_name": null,
      "last_name": null,
      "email": "testiemail@tvtools.fi",
      "user_role": {
        "name": "guest"
      }
    }
  ]
}

// User with given email does not already exist
POST /api/v2/drop_folders/49/guests
{
  "email": "testiemail@tvtools.fi"
}
200
{
  "users": [
    {
      "id": 170,
      "first_name": null,
      "last_name": null,
      "email": "admin-user-148@example.com",
      "user_role": {
        "name": "admin"
      }
    },
    {
      "id": 171,
      "first_name": null,
      "last_name": null,
      "email": "testiemail@tvtools.fi",
      "user_role": {
        "name": "guest"
      }
    }
  ]
}

Errors

Code	Description
401	Unauthorized
404	Not found
500	Internal Server Error
422	Missing parameters