The Upsun REST API uses OAuth2 bearer tokens for authentication. You exchange an API token for a short-lived access token, then include it in the Authorization header of every request.
Create an API token
You will first need to have an Upsun account and create an API Token via the Console.
Exchange for an access token
Use the token exchange endpoint to get a short-lived access token:
curl -u platform-api-user: \
-d 'grant_type=api_token&api_token=YOUR_API_TOKEN' \
https://auth.upsun.com/oauth2/token
{
"access_token": "YOUR_ACCESS_TOKEN",
"expires_in": 900,
"token_type": "bearer"
}
Make authenticated requests
Include the access token in the Authorization header:
curl -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
https://api.upsun.com/projects
Base URL: All API requests go to https://api.upsun.com.
Token lifecycle
| Property | Value |
|---|
| Token type | Bearer |
| Expires in | 900 seconds (15 minutes) |
| Exchange endpoint | https://auth.upsun.com/oauth2/token |
| Grant type | api_token |
401 Unauthorized. 
