Skip to main content

Error Codes

Complete reference for all CODITECT error codes and how to resolve them.

Error Code Format​

Error codes follow this format: CDT-XXXX

  • CDT-1XXX - Authentication errors
  • CDT-2XXX - License errors
  • CDT-3XXX - Project errors
  • CDT-4XXX - Workstation errors
  • CDT-5XXX - API errors
  • CDT-9XXX - System errors

Authentication Errors (CDT-1XXX)​

CDT-1001: Invalid Credentials​

Message: "Email or password is incorrect"

Cause: Login credentials don't match.

Solution:

  1. Verify email address
  2. Check caps lock
  3. Reset password if forgotten

CDT-1002: Account Locked​

Message: "Account temporarily locked due to too many failed attempts"

Cause: Multiple failed login attempts.

Solution:

  1. Wait 15 minutes
  2. Reset password to unlock immediately
  3. Contact support if persists

CDT-1003: Email Not Verified​

Message: "Please verify your email address"

Cause: Account created but email not confirmed.

Solution:

  1. Check inbox for verification email
  2. Check spam folder
  3. Click "Resend verification email"

CDT-1004: 2FA Required​

Message: "Two-factor authentication code required"

Cause: 2FA is enabled on account.

Solution:

  1. Enter code from authenticator app
  2. Use backup code if needed

CDT-1005: Invalid 2FA Code​

Message: "Invalid two-factor authentication code"

Cause: Code is incorrect or expired.

Solution:

  1. Wait for new code (30 seconds)
  2. Verify device time is correct
  3. Use backup code

CDT-1006: Session Expired​

Message: "Your session has expired"

Cause: Token expired or invalidated.

Solution:

  1. Log in again
  2. Enable "Remember me" for longer sessions

CDT-1007: Unauthorized​

Message: "You don't have permission to access this resource"

Cause: Insufficient permissions.

Solution:

  1. Contact organization admin
  2. Request appropriate role

License Errors (CDT-2XXX)​

CDT-2001: No Seats Available​

Message: "All license seats are currently in use"

Cause: Maximum concurrent users reached.

Solution:

  1. Wait for seat to free (auto-release after 6 min)
  2. Ask admin to release stale sessions
  3. Upgrade to more seats

CDT-2002: License Expired​

Message: "Your license has expired"

Cause: License validity period ended.

Solution:

  1. Renew subscription
  2. Update payment method
  3. Contact admin for renewal

CDT-2003: License Suspended​

Message: "License suspended due to payment failure"

Cause: Payment failed after retries.

Solution:

  1. Update payment method
  2. Pay outstanding invoice
  3. Contact billing support

CDT-2004: Invalid License Key​

Message: "The license key is invalid"

Cause: Key format incorrect or doesn't exist.

Solution:

  1. Check for typos
  2. Copy key exactly from dashboard
  3. Contact admin for correct key

CDT-2005: Hardware ID Mismatch​

Message: "Hardware ID does not match registered device"

Cause: License tied to different hardware.

Solution:

  1. Floating licenses don't have this restriction
  2. Contact support if unexpected

CDT-2006: Session Timeout​

Message: "Session expired due to inactivity"

Cause: Heartbeat not received within timeout.

Solution:

  1. Reconnect to acquire new session
  2. Check network stability
  3. Ensure browser tab is active

Project Errors (CDT-3XXX)​

CDT-3001: Project Not Found​

Message: "Project not found or you don't have access"

Cause: Project deleted or no permission.

Solution:

  1. Check project exists in dashboard
  2. Request access from project owner
  3. Check organization membership

CDT-3002: Project Limit Reached​

Message: "Maximum number of projects reached"

Cause: Plan limit exceeded.

Solution:

  1. Delete unused projects
  2. Upgrade plan for more projects

CDT-3003: Invalid Project Name​

Message: "Project name contains invalid characters"

Cause: Name has disallowed characters.

Solution:

  1. Use alphanumeric, hyphens, underscores
  2. No spaces or special characters
  3. Length 1-50 characters

CDT-3004: Project Archived​

Message: "This project has been archived"

Cause: Project was archived.

Solution:

  1. Unarchive from dashboard
  2. Contact admin if you can't unarchive

Workstation Errors (CDT-4XXX)​

CDT-4001: Workstation Start Failed​

Message: "Failed to start workstation"

Cause: Infrastructure issue.

Solution:

  1. Wait and retry
  2. Try different region
  3. Contact support with request ID

CDT-4002: Workstation Timeout​

Message: "Workstation startup timed out"

Cause: Took too long to provision.

Solution:

  1. Retry start
  2. Check if region has capacity
  3. Try smaller machine type

CDT-4003: Storage Limit Exceeded​

Message: "Project storage limit exceeded"

Cause: Files exceed storage quota.

Solution:

  1. Delete unnecessary files
  2. Add large files to .coditectignore
  3. Upgrade plan for more storage

CDT-4004: Connection Lost​

Message: "Lost connection to workstation"

Cause: Network issue or workstation stopped.

Solution:

  1. Check network connection
  2. Refresh browser
  3. Restart workstation

API Errors (CDT-5XXX)​

CDT-5001: Rate Limited​

Message: "Too many requests"

Cause: Rate limit exceeded.

Solution:

  1. Wait for rate limit reset
  2. Check Retry-After header
  3. Implement exponential backoff

CDT-5002: Invalid Request​

Message: "Request validation failed"

Cause: Malformed request body.

Solution:

  1. Check request format
  2. Verify all required fields
  3. Check data types match schema

CDT-5003: Resource Not Found​

Message: "The requested resource was not found"

Cause: Resource doesn't exist.

Solution:

  1. Verify resource ID
  2. Check permissions
  3. Resource may have been deleted

CDT-5004: Conflict​

Message: "Resource already exists"

Cause: Duplicate creation attempt.

Solution:

  1. Use existing resource
  2. Use different identifier
  3. Check for race conditions

System Errors (CDT-9XXX)​

CDT-9001: Internal Error​

Message: "An internal error occurred"

Cause: Unexpected server error.

Solution:

  1. Retry the operation
  2. Note the request ID
  3. Contact support if persists

CDT-9002: Service Unavailable​

Message: "Service temporarily unavailable"

Cause: Maintenance or overload.

Solution:

  1. Check status.coditect.ai
  2. Wait and retry
  3. Usually resolved quickly

CDT-9003: Database Error​

Message: "Database operation failed"

Cause: Database issue.

Solution:

  1. Retry the operation
  2. Note request ID
  3. Contact support

CDT-9004: Storage Error​

Message: "Storage operation failed"

Cause: File storage issue.

Solution:

  1. Retry save/load
  2. Check file size limits
  3. Contact support

Reporting Issues​

When contacting support, include:

  1. Error code (e.g., CDT-2001)
  2. Request ID (shown in error message)
  3. Timestamp when error occurred
  4. Steps to reproduce
  5. Browser and version
  6. Screenshots if helpful

Contact: 1@az1.ai