OAuth 2.0
Let users connect your app to their Atlas account. You get an access token limited to the scopes they approve, so your app can read their boards or manage todos on their behalf. Atlas implements the authorization code flow with PKCE (S256), refresh token rotation and token revocation.
Flow
Authorization code + PKCE (S256). Public and confidential clients.
Token lifetimes
Access tokens 1 hour. Refresh tokens 30 days, rotated on use.
Board limits
Users can restrict your app to chosen boards, with per-board scopes.
Endpoints
/oauth/authorizeAuthorisation endpoint (user-facing consent screen)
/api/oauth/tokenExchange a code or refresh token for tokens
/api/oauth/revokeRevoke an access or refresh token
/api/oauth/userinfoProfile of the authorising user (identify scope)
/.well-known/oauth-authorization-serverServer metadata (RFC 8414)
1Register an application
3Exchange the code
curl -X POST https://atlas.s8n.xyz/api/oauth/token -d grant_type=authorization_code -d code=AUTH_CODE -d redirect_uri=https://example.com/callback -d client_id=YOUR_CLIENT_ID -d code_verifier=ORIGINAL_VERIFIER -d client_secret=YOUR_SECRET # confidential clients onlyResponse
{
"access_token": "oat_…",
"token_type": "Bearer",
"expires_in": 3600,
"refresh_token": "ort_…",
"scope": "identify boards:read todos:write todos:update"
}4Call the API
curl https://atlas.s8n.xyz/api/v1/boards -H "Authorization: Bearer oat_…"curl -X POST https://atlas.s8n.xyz/api/oauth/token -d grant_type=refresh_token -d refresh_token=ort_… -d client_id=YOUR_CLIENT_IDScopes
identifyRead your basic profile (id, username, avatar)boards:readRead your boards, categories and tagsboards:writeCreate boards, categories and tagsboards:updateEdit and reorder boards, categories and tagsboards:deleteDelete boards, categories and tagstodos:readRead todos and the todo historytodos:writeCreate todostodos:updateEdit, move, complete, scrap and restore todostodos:deleteDelete todos (to History), delete them permanently and empty Historydata:exportExport your boards and todosdata:importImport boards and todosRequests for a scope your app isn't registered for are rejected. Management endpoints such as API keys and apps are never available to OAuth tokens.
Errors
unauthorizedMissing, invalid, expired or revoked credentialforbidden / insufficient_scopeThe credential lacks the scope or the action is website-onlyrate_limitedToo many requests – see Retry-AfterTry the flow
1Pick your app and scopes
Must exactly match one of the app's registered redirect URIs.
2Exchange the code for tokens
After approving you're sent back here with ?code=…. The code is single use and expires in 10 minutes.
3Call the API
Complete step 2 first.