The ProteusAI Messaging API uses tokens to authenticate requests. You can view and manage your tokens in the Setup page for your ProteusAI account.
Click on the Add User Token
button to add a new token for your account. You can always delete a token; API calls based on the deleted token will no longer work.
You can authenticate your request by sending the token in the Authorization
header of the request. For example:
curl --request GET \
--url "https://messaging-api.useproteus.ai/conversations/77542a3587659db1a6ce5058/messages" \
--header "Authorization: Bearer 66563d92e59961d11fc67a39"
You can authenticate SDKs by providing the token to the initializer of the SDK.
import ProteusAI from '@proteus-ai/sdk';
const proteus = new ProteusAI({ apiKey: '66563d92e59961d11fc67a39' });
If you make calls to protected API endpoints without a token or with an invalid token, you will receive a 401 Unauthorized
response.
Your API tokens carry many privileges, so be sure to keep them secure! Do not share your tokens in publicly accessible areas such as GitHub, client-side code, and so forth.