Admins
List admin roles
Returns all available admin roles and their permissions.
This endpoint returns all roles at once (typically a small list). No pagination is supported.
Response Format
Returns a list object with:
object- Always "list"data- Array of admin role objectsnextCursor- Always null
Admin Role Object
Each role includes:
id- Unique role identifiername- Role name (e.g., "Admin", "Viewer")permissions- Object containing permission flags
Permissions
The permissions object contains boolean flags for each permission:
view_comments_private- Can view private commentsmanage_comments- Can manage commentsmanage_comments_private- Can manage private commentsset_comment_pinned- Can pin commentsmoderate_comments- Can moderate commentsset_post_category- Can change post categoriesset_post_pinned- Can pin postsset_post_eta- Can set post ETAset_post_tags- Can manage post tagsset_post_author- Can change post authorset_post_status- Can change post statusset_post_assignee- Can assign postsset_post_custom_fields- Can edit custom fieldspost_vote_on_behalf- Can vote on behalf of userspost_merge- Can merge postspost_import- Can import postspost_export- Can export postsmoderate_posts- Can moderate postsview_users- Can view usersmanage_users- Can manage usersview_posts_private- Can view private postsview_private_post_tags- Can view private tagsmanage_changelogs- Can manage changelogsmanage_surveys- Can manage surveysmanage_branding- Can manage brandingmanage_billing- Can manage billingmanage_team_members- Can manage team membersmanage_sso- Can manage SSO settingsmanage_api- Can manage API settingsmanage_statuses- Can manage statusesmanage_boards- Can manage boardsmanage_post_tags- Can manage post tagsmanage_custom_fields- Can manage custom fieldsmanage_moderation_settings- Can manage moderationmanage_roadmap- Can manage roadmapmanage_user_roles- Can manage user rolesmanage_prioritization- Can manage prioritizationmanage_notifications- Can manage notificationsmanage_custom_domain- Can manage custom domainmanage_integrations- Can manage integrationsuse_integrations- Can use integrationsmanage_help_center- Can manage help centermanage_outbound- Can manage outbound messagesmanage_outbound_state- Can manage outbound message stateauto_approve_posts- Posts auto-approved