Profile Management

Manage user profile and account settings

GET https://api.superbox.ai/v1/auth/profile

Profile Management

cURL

curl --request GET \
  --url https://api.superbox.ai/v1/auth/profile \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "username": "<string>",
  "bio": "<string>",
  "website": "<string>",
  "location": "<string>",
  "avatar_url": "<string>",
  "current_password": "<string>",
  "new_password": "<string>",
  "password": "<string>",
  "confirm": true
}
'

Get Profile

Endpoint

GET /auth/profile

Headers

Authorization · string · required

Bearer token header, e.g. Authorization: Bearer <token>

Example Request

cURL
curl https://api.superbox.ai/v1/auth/profile \
  -H "Authorization: Bearer YOUR_TOKEN"

Response (200)

{
  "id": "usr_1234567890",
  "email": "[e-mail]",
  "username": "areebahmed",
  "avatar_url": "https://avatars.superbox.ai/areebahmed.jpg",
  "bio": "Building amazing MCP servers",
  "website": "https://areeb.dev",
  "location": "Mumbai, India",
  "github_username": "areebahmeddd",
  "created_at": "2024-01-01T00:00:00Z",
  "updated_at": "2024-01-15T10:30:00Z",
  "stats": {
    "servers_published": 5,
    "total_downloads": 1234,
    "followers": 42,
    "following": 18
  },
  "subscription": {
    "plan": "pro",
    "status": "active",
    "expires_at": "2025-01-01T00:00:00Z"
  }
}

Update Profile

Endpoint

PATCH /auth/profile

Request Body

username · string

New username

bio · string

User biography (max 500 characters)

website · string

Website URL

location · string

User location

avatar_url · string

Avatar image URL

Example Request

cURL
curl -X PATCH https://api.superbox.ai/v1/auth/profile \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "bio": "Building MCP servers for AI",
    "website": "https://areeb.dev",
    "location": "San Francisco"
  }'

Response (200)

{
  "id": "usr_1234567890",
  "username": "areeb",
  "bio": "Building MCP servers for AI",
  "website": "https://areeb.dev",
  "location": "San Francisco",
  "updated_at": "2024-01-15T10:35:00Z"
}

Change Password

Endpoint

POST /auth/change-password

Request Body

current_password · string · required

Current password

new_password · string · required

New password (min 8 characters)

Example Request

cURL
curl -X POST https://api.superbox.ai/v1/auth/change-password \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "current_password": "OldPass123!",
    "new_password": "NewSecurePass456!"
  }'

Response (200)

{
  "message": "Password changed successfully"
}

Delete Account

Endpoint

DELETE /auth/profile

Request Body

password · string · required

Current password for confirmation

confirm · boolean · required

Must be true to confirm deletion

Example Request

curl -X DELETE https://api.superbox.ai/v1/auth/profile \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "password": "SecurePass123!",
    "confirm": true
  }'

Response (200)

{
  "message": "Account deleted successfully"
}

Account deletion is permanent and cannot be undone. All servers and data will be deleted.