The admin model
Example Object
{\n \"type\": \"admin\",\n \"id\": \"493881\",\n \"name\": \"Hoban Washburne\",\n \"email\": \"wash@serenity.io\",\n \"job_title\": \"Philosopher\",\n \"away_mode_enabled\": false,\n \"away_mode_reassign\": false,\n \"has_inbox_seat\": true,\n \"team_ids\": [\n 814865\n ]\n}
Admins are the teammate accounts that have access to a workspace.
Admin Object
Key | Type | Description |
---|---|---|
type | string | Value is admin . |
id | string | The id of the admin |
name | string | The name of the admin |
string | The email address of the admin | |
job_title | string | The job title of the admin |
away_mode_enabled | boolean | Identifies if this admin is currently set in away mode. |
away_mode_reassign | boolean | Identifies if this admin is set to automatically reassign new conversations to the apps default inbox. |
has_inbox_seat | boolean | Identifies if a teammate has a paid inbox seat to restrict/allow features that require them |
team_ids | list | This is a list of teams id's that you are part of |
avatar | url | Image for the associated team or teammate |
As inbox seats are a new feature with our new pricing plans, customers not migrated to our new pricing will have has_inbox_seat
set to true
.
We only check if the teammate making the API call has seats, not the app itself, nor all admins within the app.
If an admin has_inbox_seats
set to false
, then certain calls will fail, such as:
Setting an admin to have away mode and/or to reassign conversations Assigning a conversation to an admin or a team Adding or removing another customer to a group conversation
If it fails, we let the developer know by returning a 403 Forbidden error, alongside a clarifying error code/message as can be seen in the examples to the right.