Authentication

Aura uses the Bearer Token authentication scheme. Most endpoints require a valid access token.

Obtaining a Token

Send a POST request to /users/tokens/sign_in with your email and password.

{
  "email": "user@example.com",
  "password": "secretpassword"
}

The response contains a Bearer access token:

{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "refresh_token": "...",
  "token_type": "Bearer"
}

Using the Token

Include the token in the Authorization header for all authenticated requests:

Authorization: Bearer <YOUR_ACCESS_TOKEN>

curl -X POST "https://aura.authot.app/api/v1/transcribs" \
     -H "Authorization: Bearer your_token_here" \
     -F "transcrib[name]=Interview" \
     -F "transcrib[lang]=fr" \
     -F "transcrib[media]=@recording.wav"

Signing Out

Revoke your session by sending a DELETE request to /users/tokens/sign_out.

Password Reset

If you need to reset your password:

1. Send a POST request to /users/password with your email to receive a reset link.
2. Use the token from the email to send a PATCH request to /users/password with your new password.