Skip to main content

Adding a member

You can add members to your organization using either the web UI or the CLI. The web UI is the recommended approach for most users.

Prerequisites​

Ensure that you have the global admin role assigned to your account. This feature is primarily gated by global admin privileges.

  1. Access Member Settings

  2. Add a New Member

    • Click the "Add Member" button
    • Select the target organization from the dropdown
    • Enter the user's ID (they can find this using astroctl whoami)
    • Choose the appropriate role: viewer, editor, or admin
    • Click "Add Member"

  3. Role Assignment

    • viewer: Read-only access to organization resources
    • editor: Can edit resources but has limited deployment permissions
    • admin: Can manage all resources within the organization, including API keys and member management

Method 2: Using the CLI​

  1. Add User to Organization

    astroctl org add-user --org-id [org-id] --user-id [user-id]

  2. Generate API Keys Once the member is added, they must run the following command to generate API keys and access all the resources for that organization:

    astroctl auth login --org-id [org-id]
Global Admin Role Required

To add members to organizations, you must have the global admin role assigned to your account. This feature is primarily gated by global admin privileges.

Finding User IDs

Users can find their user ID by running astroctl whoami in their terminal.