Exchange Partner JWT

Exchange a partner JWT for a local JWT token that can be used to access protected endpoints. **Partner Integration Guide:** 1. Obtain a valid JWT from your partner token issuer 2. Send the partner token in the request body 3. Receive a local JWT token in response 4. Use the local JWT token in Authorization header for subsequent API calls **Error Troubleshooting:** - `INVALID_TOKEN`: Token format or content is invalid - `TOKEN_EXPIRED`: Partner token has expired - `INVALID_TOKEN_SIGNATURE`: Token signature verification failed - `UNKNOWN_TOKEN_ISSUER`: Organization issuer is not recognized - `MALFORMED_TOKEN`: Token structure is malformed - `INVALID_TOKEN_CLAIMS`: Required token claims are missing or invalid

curl -X POST "https://example.com/v1/auth/exchange" \  -H "Content-Type: application/json" \  -d '{    "partner_token": "string"  }'

{  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",  "token_type": "Bearer",  "expires_in": 3600}

{  "code": "INVALID_TOKEN",  "description": "The provided token is invalid"}

{  "code": "UNAUTHORISED",  "description": "Authentication credentials are missing or invalid"}

{  "code": "FORBIDDEN",  "description": "Access denied to token exchange endpoint"}

{  "code": "INTERNAL_ERROR",  "description": "An unexpected error occurred"}