Skip to main content

Roles & Invites

Manage user roles and send invitations. Requires GHOST_ADMIN_API_KEY.

Tools

ToolDescription
admin_browse_rolesList all available roles
admin_create_inviteSend an invitation to a new user

admin_browse_roles

List all available roles in the system.

{}

Returns roles such as:

  • Owner — Full control over the site
  • Administrator — Full access to settings and content
  • Editor — Can manage and publish content
  • Author — Can create and edit their own content
  • Contributor — Can create drafts but not publish

admin_create_invite

Send an invitation email to a new user.

{
"email": "newauthor@example.com",
"role_id": "role-id-here"
}

Key parameters

ParameterTypeDescription
emailstringEmail address to invite (required)
role_idstringRole ID to assign (required)
tip

Use admin_browse_roles first to get the available role IDs, then pass the desired role ID when creating an invite.