When using Fuse’s APIs, you must obtain an authentication token when authenticatingTo call Fuse API endpoints you need to be authenticated. This is done by sending your authentication token in a header called “Auth-Token” with every API request. From v5.0 onwards, we’ve introduced rotating authentication tokens, which means that each authentication token expires and renews at regular intervals.
...
To obtain a JWT token for your session, you must use the following POST
request:
POST
...
/session
Request
POSTURL: /session https://<instance_name>.fuseuniversal.com/api/v5.0/session
...
When using this request, you must include the following mandatory parameters in the request body:
login_name: This is your username or email address used to log in to your Fuse instance, assigned to you when your account was created (e.g. joe.bloggs or joe.blogs@email.com).
password: This is your password used to log in to your Fuse instance.
...
Code Block |
---|
{ "success": true, "role": "admin", "administerable_community_ids": [ 9, 10, 11 ], "admin_group_permissions": [ "compliance_reporting" ], "is_manager": true, "terms_and_conditions_accepted": true, "password_change_required": false, "terms_and_conditions": null, "password_requirements": null, "jwt_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJIb3RmaXgiLCJleHAiOjE3MzIxNDcxOTksImlhdCI6MTcyOTUwNTc3NiwiYXVkIjpudWxsLCJqdGkiOiIyOTQ5OS4xOTI4NTYifQ.qz_fLuuTvyUTveheP8bwLwnDBgw_KpjZTdMEUf2WSnY", "auth_tokens": { "jwt_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJIb3RmaXgiLCJleHAiOjE3MzIxNDcxOTksImlhdCI6MTcyOTUwNTc3NiwiYXVkIjpudWxsLCJqdGkiOiIyOTQ5OS4xOTI4NTYifQ.qz_fLuuTvyUTveheP8bwLwnDBgw_KpjZTdMEUf2WSnY", "user_authentication_token": { "authentication_token": "RVt-k4zQJRyMBx3L", "updated_at": 1728784853 } } } |
Obtaining a token using cURL
Below is an example of how to obtain a token using cURL:
Request
curl --header 'Auth-Token: token_value_here' https://<instance_name>.fuseuniversal.com/api/v5.0/users/me
Example response
Code Block |
---|
{
"authentication_token": "rVIG4LQ8kNvyu763",
"updated_at": 1728957654
} |
Info |
---|
When using the legacy Fuse API (v4.4 and below), the request is as follows:
|
...
Info |
---|
For more information about the |