Get / reset API token

POSThttps://www.eclipseproxy.com/api/user-api/auth

POST your account email and password to receive a fresh API token.

Calling this endpoint invalidates your previous token. Update any services using the old token immediately.

Example request

curl -X POST "https://www.eclipseproxy.com/api/user-api/auth" \
  -H "Content-Type: application/json" \
  -d '{"email": "[email protected]", "password": "your_account_password"}'

Parameters

No authorization required for this endpoint. Use your email and password instead.

Body parameters

emailbodystringrequired

Your EclipseProxy account email.

passwordbodystringrequired

Your EclipseProxy account password.

Response

statusstringrequired

"success" when the token was generated.

messagestring

Human-readable confirmation.

dataobjectrequired

data properties

apiTokenstringrequired

The new API token. Store securely and include as Authorization: Bearer <token> on every other endpoint.

Rate limit

1 request per 5 minutes per account and per IP. Store the token and reuse it: don't call this on every request.

Example response

{
  "status": "success",
  "message": "API token generated and previous token (if any) invalidated",
  "data": {
    "apiToken": "NEW_API_TOKEN"
  }
}

When to rotate

Token was exposed (committed to a repo, leaked in logs, shared)
Routine security rotation
A teammate left and may have had access

Calling this endpoint generates a new token and invalidates the old one. Update every script that uses the old token.

Errors

401: wrong email or password
429: rate-limited (you hit the 1-per-5-min cap)
5xx: internal error; retry with exponential backoff

On this page