Invitations

Learn how to accept invitations to join existing organizations in Orkestia.

What are Organization Invitations?

Organization invitations allow team members to join an existing organization without creating their own. When you're invited:

• You receive an email with an invitation link
• You can accept the invitation by creating an account or signing in
• You're automatically added to the organization with the assigned role
• You gain access to the organization's resources

How Invitations Work

Receiving an Invitation

When someone invites you to their organization, you'll receive an email containing:

• Organization Name - The name of the organization you're joining
• Inviter Name - Who sent the invitation
• Your Role - The role you'll have (Admin, Member, etc.)
• Invitation Link - A secure link to accept the invitation
• Expiration Date - When the invitation expires

Accepting an Invitation

https://app.orkestia.dev/invite/abc123xyz789...

Email Mismatch

If you're logged in but your email doesn't match the invitation:

You have two options:

Option 1: Switch Account

1. Click Switch to invitation email
2. Sign out and sign in with the correct email
3. Accept the invitation

Option 2: Continue to Dashboard

1. Click Continue to dashboard instead
2. Use your current account
3. Ask the inviter to send a new invitation to your current email

Invitation Statuses

Automatic Acceptance

If you create an account using the same email as the invitation:

• The invitation is automatically accepted during account creation
• You're immediately added to the organization
• You'll see a success message when logging in
• No manual acceptance needed

Roles and Permissions

When you accept an invitation, you're assigned a role:

Admin Role

• Full access to organization settings
• Can invite and remove members
• Can manage subscriptions and billing
• Can delete the organization

Member Role

• Can deploy applications
• Can view organization resources
• Cannot modify organization settings
• Cannot invite members

After Accepting an Invitation

Once you've accepted an invitation:

1. You're Added - Automatically added to the organization
2. Workspace Loads - Organization data loads in the background
3. Dashboard Access - Redirected to the main dashboard
4. Full Access - Can use organization resources based on your role

Multiple Organizations

You can belong to multiple organizations:

• Each invitation adds you to a different organization
• You can switch between organizations in the dashboard
• Your role may differ in each organization
• All organizations appear in your account

Invitation Expiration

Invitations expire after a set period:

• Check Expiration - Shown on the invitation page
• Expired Invitations - Cannot be accepted
• Request New Invitation - Contact the organization admin

Troubleshooting Invitations

Invitation Link Doesn't Work

Possible causes:

• Link has expired
• Invitation was cancelled
• Link was copied incorrectly

Solution:

• Request a new invitation from the organization admin
• Check if the link is complete (no truncation)

Already Accepted

Problem: Invitation shows as already accepted

Solution:

• You're already in the organization
• Check your organization list in the dashboard
• Contact support if you can't access the organization

Invitation Expired

Problem: Invitation has expired

Solution:

• Request a new invitation from the organization admin
• New invitations have a fresh expiration date

Security Notes

• Email Verification - Your email must match the invitation exactly
• Secure Links - Invitation tokens are unique and time-limited
• One-Time Use - Each invitation can typically only be accepted once
• Role Assignment - Roles are assigned by the inviter, not you

Next Steps

After accepting an invitation: