Auth API Reference

Authorization: Bearer <access_token>

// Request
{
  "email": "user@example.com",
  "password": "securePassword123",
  "displayName": "Alex"
}
 
// Response 201
{
  "userId": "user_abc123",
  "profileId": "profile_xyz",
  "accessToken": "eyJ...",
  "refreshToken": "rt_...",
  "expiresIn": 900
}

// Request
{
  "email": "user@example.com",
  "password": "securePassword123"
}
 
// Response 200
{
  "userId": "user_abc123",
  "activeProfileId": "profile_xyz",
  "accessToken": "eyJ...",
  "refreshToken": "rt_...",
  "expiresIn": 900
}

// Request
{
  "provider": "google",
  "code": "auth_code_from_provider",
  "redirectUri": "https://your-app.com/callback"
}

// Request
{
  "refreshToken": "rt_..."
}
 
// Response 200
{
  "accessToken": "eyJ...",
  "refreshToken": "rt_new...",
  "expiresIn": 900
}

Authorization: Bearer <access_token>

// Response 200
{
  "userId": "user_abc123",
  "activeProfileId": "profile_xyz",
  "roles": ["builder"],
  "expiresAt": "2025-03-01T12:00:00Z"
}

// Response 200
{
  "profiles": [
    {
      "id": "profile_xyz",
      "displayName": "Alex",
      "avatar": "https://cdn.shellapps.com/avatars/abc.png",
      "isActive": true
    }
  ]
}

// Request
{
  "displayName": "Work Alex",
  "avatar": "https://example.com/avatar.png"
}

// Response 200
{
  "activeProfileId": "profile_abc",
  "accessToken": "eyJ..."
}

// Request
{
  "displayName": "New Name",
  "avatar": "https://example.com/new-avatar.png"
}

{
  "profileId": "profile_xyz",
  "role": "editor"
}

{
  "error": {
    "code": "INVALID_CREDENTIALS",
    "message": "Email or password is incorrect",
    "status": 401
  }
}