Skip to main content

Account Setup

This guide covers essential account configuration including security settings, profile customization, and organization management.

Profile Settings

Basic Information

Navigate to Dashboard → Settings → Profile to configure:

FieldDescription
Display NameYour name shown to team members
EmailPrimary email for notifications
AvatarProfile picture (supports upload or Gravatar)
TimezoneUsed for activity timestamps
LanguageInterface language preference

Update Profile

# Using CLI
coditect profile update --name "John Doe" --timezone "America/New_York"

Security Settings

Two-factor authentication (2FA) adds an extra layer of security to your account.

  1. Go to Settings → Security
  2. Click Enable 2FA
  3. Choose your method:
    • Authenticator App (Recommended): Use Google Authenticator, Authy, or 1Password
    • SMS: Receive codes via text message (less secure)

Setup with Authenticator App

  1. Scan the QR code with your authenticator app
  2. Enter the 6-digit code to verify
  3. Save your backup codes in a secure location
Backup Codes

Store your backup codes securely. If you lose access to your authenticator app, you'll need these codes to recover your account.

Password Requirements

CODITECT enforces strong password policies:

  • Minimum 12 characters
  • At least one uppercase letter
  • At least one lowercase letter
  • At least one number
  • At least one special character

Session Management

View and manage active sessions:

  1. Navigate to Settings → Security → Sessions
  2. View all active sessions with:
    • Device type and browser
    • IP address and location
    • Last activity timestamp
  3. Click Revoke to terminate any suspicious sessions

Organization Settings

Create an Organization

If you haven't already created an organization:

  1. Click your profile menu → Create Organization
  2. Enter organization details:
    • Name: Display name for your organization
    • Slug: URL-safe identifier (e.g., acme-engineering)
    • Description: Optional description
  3. Select your subscription plan
  4. Click Create

Organization Roles

RolePermissions
OwnerFull access, billing, delete organization
AdminManage members, projects, settings
MemberCreate projects, access workspaces
ViewerRead-only access to projects

Invite Team Members

  1. Go to Organization → Members
  2. Click Invite Members
  3. Enter email addresses (comma-separated for bulk)
  4. Select role for invited members
  5. Click Send Invitations
# Using CLI
coditect org invite --email "colleague@company.com" --role member

Notification Preferences

Configure how you receive notifications:

Email Notifications

CategoryOptions
Security AlertsNew sign-in, password changes
Team ActivityInvitations, member changes
Project UpdatesDeployments, comments
BillingInvoices, payment issues

In-App Notifications

Toggle notifications for:

  • Mentions and comments
  • Project deployments
  • Team activity
  • System announcements

API Keys

Generate Personal Access Token

For API access and CLI authentication:

  1. Go to Settings → API Keys
  2. Click Generate New Token
  3. Name your token (e.g., "CI/CD Pipeline")
  4. Set expiration (recommended: 90 days)
  5. Select scopes:
    • read:projects - Read project data
    • write:projects - Create/modify projects
    • admin:org - Organization management
  6. Click Generate
Token Security

Your token is only shown once. Copy and store it securely. If lost, revoke and regenerate.

Token Usage

# Set token in environment
export CODITECT_TOKEN="your-token-here"

# Or use in API requests
curl -H "Authorization: Bearer your-token-here" \
https://api.coditect.ai/v1/projects

Connected Accounts

Link external accounts for enhanced features:

GitHub

  1. Go to Settings → Integrations → GitHub
  2. Click Connect GitHub
  3. Authorize CODITECT to access your repositories
  4. Select repositories to import (optional)

Google Cloud

  1. Go to Settings → Integrations → Google Cloud
  2. Click Connect Google Cloud
  3. Select your GCP project
  4. Grant necessary IAM permissions

Data & Privacy

Export Your Data

Request a copy of all your data:

  1. Go to Settings → Privacy
  2. Click Request Data Export
  3. You'll receive an email with download link within 48 hours

Delete Account

Permanent Action

Account deletion is permanent and cannot be undone. All your data, projects, and settings will be permanently deleted.

To delete your account:

  1. Transfer ownership of any organizations
  2. Go to Settings → Privacy → Delete Account
  3. Enter your password to confirm
  4. Type "DELETE" to proceed

Next: Your First Project