Property Users Collection

API methods to work with Property Users
Property User is an association between a Property and and User, represents who can manage a property and with which role and access rights.
Property Users List
Retrieve list of properties associated with user.
Request
Success Response
Error Response
Request
Request:
GET https://staging.channex.io/api/v1/property_users?filter[property_id]=PROPERTY_ID
Success Response
Success Response Example
Status Code: 200 OK
{
  "data": [
    {
      "id": "776533f2-c10e-49d8-bddc-14b3e27c2a00",
      "type": "property_user"
      "attributes": {
        "id": "776533f2-c10e-49d8-bddc-14b3e27c2a00",
        "overrides": null,
        "property_id": "52397a6e-c330-44f4-a293-47042d3a3607",
        "role": "owner",
        "user_id": "c9cfa184-5095-4ef2-bbe2-e723ffb49184"
      },
      "relationships": {
        "property": {
          "data": {
            "id": "52397a6e-c330-44f4-a293-47042d3a3607",
            "type": "property"
          }
        },
        "user": {
          "data": {
            "id": "c9cfa184-5095-4ef2-bbe2-e723ffb49184",
            "type": "user",
            "email": "user@channex.io",
            "name": "Channex User"
          }
        }
      }
    }
  ]
}
Error Response
Unauthorised Error Response
Status Code: 401 Unauthorized
{
  "errors": {
    "code": "unauthorized",
    "title": "Unauthorized"
  }
}
Returns
Success
Method can return a Success result with 200 OK HTTP Code if operation is successful. Will contain a list of Property User objects in the answer.

Unauthorised Error
Method can return a Unauthorised Error result with 401 Unauthorized HTTP Code if wrong Bearer Token provided. 
Invite User to Property
Create new Property User.
Request
Success Response
Error Response
Request
Request:
POST https://staging.channex.io/api/v1/property_users
Query body (JSON):
{
  "invite": {
    "property_id": "52397a6e-c330-44f4-a293-47042d3a3607",
    "user_email": "other_user@channex.io",
    "role": "user",
    "overrides": {}
  }
}
Success Response
Success Response Example
Status Code: 201 Created
{
  "data": {
    "id": "776533f2-c10e-49d8-bddc-14b3e27c2a00",
    "type": "property_user"
    "attributes": {
      "id": "776533f2-c10e-49d8-bddc-14b3e27c2a00",
      "overrides": null,
      "property_id": "52397a6e-c330-44f4-a293-47042d3a3607",
      "role": "owner",
      "user_id": "c9cfa184-5095-4ef2-bbe2-e723ffb49184"
    },
    "relationships": {
      "property": {
        "data": {
          "id": "52397a6e-c330-44f4-a293-47042d3a3607",
          "type": "property"
        }
      },
      "user": {
        "data": {
          "id": "c9cfa184-5095-4ef2-bbe2-e723ffb49184",
          "type": "user",
          "email": "user@channex.io",
          "name": "Channex User"
        }
      }
    }
  }
}
Error Response
Bad Request Error Response
Status Code: 400 Bad Request
{
  "errors": {
    "code": "bad_request",
    "title": "Bad Request",
    "details": "User already invited"
  }
}
Unauthorised Error Response
Status Code: 401 Unauthorized
{
  "errors": {
    "code": "unauthorized",
    "title": "Unauthorized"
  }
}
Forbidden Error Response
Status Code: 403 Forbidden
{
  "errors": {
    "code": "forbidden",
    "title": "Forbidden"
  }
}
Validation Error Response
Status Code: 422 Unprocessable Entity
{
  "errors": {
    "code": "validation_error",
    "title": "Validation Error",
    "details": {
      "user_email": [
        "can't be blank"
      ]
    }
  }
}
Fields
property_id [required]
String with valid UUID for Property object what you would use as target for invitation.
user_email [required]
String with a valid email address of invited user.
Note: If user is not registered at our system, we are create they account automatically and send email with instructions to on-board into channex.io.
role [required]
String with a valid role name.
Right now you can use 2 roles - owner and user.
overrides [optional]
JSON Object with access policies overrides.
Returns
Success
Method can return a Success result with 201 Created HTTP Code if operation is successful. Will contain a Property User object in the answer.

Bad Request Error
Method can return a Bad Request Error result with 400 Bad Request HTTP Code if provided user already invited.

Unauthorised Error
Method can return a Unauthorised Error result with 401 Unauthorized HTTP Code if wrong Bearer Token provided.

Forbidden Error
Method can return a Forbidden Error result with 403 Forbidden HTTP Code if current user not have permissions to invite user into provided property.
Validation Error
Method can return a Validation Error result with 422 Unprocessable Entity HTTP Code if any validation rule is failed.
Get Property User by ID
Retrieve Property User by ID.
Request
Success Response
Error Response
Request
Request:
GET https://staging.channex.io/api/v1/property_users/:id
Success Response
Success Response Example
Status Code: 200 OK
{
  "data": {
    "id": "776533f2-c10e-49d8-bddc-14b3e27c2a00",
    "type": "property_user"
    "attributes": {
      "id": "776533f2-c10e-49d8-bddc-14b3e27c2a00",
      "overrides": null,
      "property_id": "52397a6e-c330-44f4-a293-47042d3a3607",
      "role": "owner",
      "user_id": "c9cfa184-5095-4ef2-bbe2-e723ffb49184"
    },
    "relationships": {
      "property": {
        "data": {
          "id": "52397a6e-c330-44f4-a293-47042d3a3607",
          "type": "property"
        }
      },
      "user": {
        "data": {
          "id": "c9cfa184-5095-4ef2-bbe2-e723ffb49184",
          "type": "user",
          "email": "user@channex.io",
          "name": "Channex User"
        }
      }
    }
  }
}
Error Response
Validation Error Response
Status Code: 401 Unauthorized
{
  "errors": {
    "code": "unauthorized",
    "title": "Unauthorized"
  }
}
Forbidden Error Response
Status Code: 403 Forbidden
{
  "errors": {
    "code": "forbidden",
    "title": "Forbidden"
  }
}
Returns
Success
Method can return a Success result with 200 OK HTTP Code if operation is successful. Will contain a Property User object in the answer.

Unauthorised Error
Method can return a Unauthorised Error result with 401 Unauthorized HTTP Code if wrong Bearer Token provided. 

Forbidden Error
Method can return a Forbidden Error result with 403 Forbidden HTTP Code if current user not have permissions to call this action.
Update Property User
Update property access information.
Request
Success Response
Error Response
Request
Request:
PUT https://staging.channex.io/api/v1/property_users/:id
Query body (JSON):
{
  "property_user": {
    "role": "user",
    "overrides": null
  }
}
Success Response
Success Response Example
Status Code: 200 OK
{
  "data": {
    "id": "776533f2-c10e-49d8-bddc-14b3e27c2a00",
    "type": "property_user"
    "attributes": {
      "id": "776533f2-c10e-49d8-bddc-14b3e27c2a00",
      "overrides": null,
      "property_id": "52397a6e-c330-44f4-a293-47042d3a3607",
      "role": "owner",
      "user_id": "c9cfa184-5095-4ef2-bbe2-e723ffb49184"
    },
    "relationships": {
      "property": {
        "data": {
          "id": "52397a6e-c330-44f4-a293-47042d3a3607",
          "type": "property"
        }
      },
      "user": {
        "data": {
          "id": "c9cfa184-5095-4ef2-bbe2-e723ffb49184",
          "type": "user",
          "email": "user@channex.io",
          "name": "Channex User"
        }
      }
    }
  }
}
Error Response
Unauthorised Error Response
Status Code: 401 Unauthorized
{
  "errors": {
    "code": "unauthorized",
    "title": "Unauthorized"
  }
}
Forbidden Error Response
Status Code: 403 Forbidden
{
  "errors": {
    "code": "forbidden",
    "title": "Forbidden"
  }
}
Resource Not Found Error Response
Status Code: 404 Not Found
{
  "errors": {
    "code": "resource_not_found",
    "title": "Resource Not Found"
  }
}
Validation Error Response
Status Code: 422 Unprocessable Entity
{
  "errors": {
    "code": "validation_error",
    "title": "Validation Error",
    "details": {
      "role": [
        "can't be blank"
      ]
    }
  }
}
Fields
Through this method you can update only two fields - role and overrides. Please see Invite User to Property for more detailed information.
Returns
Success
Method can return a Success result with 200 OK HTTP Code if operation is successful. Will contain a Property User object in the answer.

Unauthorised Error
Method can return a Unauthorised Error result with 401 Unauthorized HTTP Code if wrong Bearer Token provided.

Forbidden Error
Method can return a Forbidden Error result with 403 Forbidden HTTP Code if current user not have permissions to call this action.

Resource Not Found Error
Method can return a Resource Not Found Error result with 404 Not Found HTTP Code if requested Property User is not defined.
Validation Error
Method can return a Validation Error result with 422 Unprocessable Entity HTTP Code if any validation rule is failed.
Withdraw Property User Access
Revoke Property User access to a specific property.
Request
Success Response
Error Response
Request
Request:
DELETE https://staging.channex.io/api/v1/property_users/:id
Success Response
Success Response Example
Status Code: 200 OK
{
  "meta": {
    "message": "Success"
  }
}
Error Response
Bad Request Error Response
Status Code: 400 Bad Request
{
  "errors": {
    "code": "bad_request",
    "details": "User can not withdraw themself",
    "title": "Bad Request"
  }
}
Unauthorised Error Response
Status Code: 401 Unauthorized
{
  "errors": {
    "code": "unauthorized",
    "title": "Unauthorized"
  }
}
Forbidden Error Response
Status Code: 403 Forbidden
{
  "errors": {
    "code": "forbidden",
    "title": "Forbidden"
  }
}
Resource Not Found Error Response
Status Code: 404 Not Found
{
  "errors": {
    "code": "resource_not_found",
    "title": "Resource Not Found"
  }
}
Returns
Success
Method can return a Success result with 200 OK HTTP Code if operation is successful.

Bad Request Error
Method can return a Bad Request Error result with 400 Bad Request HTTP Code if user will try to remove them self.

Unauthorised Error
Method can return a Unauthorised Error result with 401 Unauthorized HTTP Code if wrong Bearer Token provided.

Forbidden Error
Method can return a Forbidden Error result with 403 Forbidden HTTP Code if current user not have permissions to call this action.

Resource Not Found Error
Method can return a Resource Not Found Error result with 404 Not Found HTTP Code if requested Property User is not defined.
API v.1 Documentation - Previous
Properties Collection
Next - API v.1 Documentation
Groups Collection
Last updated 7 months ago