Property User is an association between a Property and and User, represents who can manage a property and with which role and access rights.
Retrieve list of properties associated with user.
Request:
GET https://staging.channex.io/api/v1/property_users?filter[property_id]=PROPERTY_ID
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"}}}}]}
Unauthorised Error Response
Status Code: 401 Unauthorized
{"errors": {"code": "unauthorized","title": "Unauthorized"}}
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.
Create new Property User.
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 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"}}}}}
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"]}}}
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.
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.
Retrieve Property User by ID.
Request:
GET https://staging.channex.io/api/v1/property_users/:id
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"}}}}}
Validation Error Response
Status Code: 401 Unauthorized
{"errors": {"code": "unauthorized","title": "Unauthorized"}}
Forbidden Error Response
Status Code: 403 Forbidden
{"errors": {"code": "forbidden","title": "Forbidden"}}
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 access information.
Request:
PUT https://staging.channex.io/api/v1/property_users/:id
Query body (JSON):
{"property_user": {"role": "user","overrides": null}}
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"}}}}}
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"]}}}
Through this method you can update only two fields - role and overrides. Please see Invite User to Property for more detailed information.
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.
Revoke Property User access to a specific property.
Request:
DELETE https://staging.channex.io/api/v1/property_users/:id
Success Response Example
Status Code: 200 OK
{"meta": {"message": "Success"}}
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"}}
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.