Chat / Platform API
Current version: v3
    Chat Platform API v3
    Chat Platform API
    Chat
    Platform API
    Home
    /
    Chat
    /
    Platform API

    Generate a secondary API token

    Generates a new secondary API token.


    Managing multiple secondary API tokens with the master API token

    You have access to most of the Chat API with just a secondary API token, except the functionality to manage the tokens including listing, generating, or revoking. Such functionality is only for the master API token.

    The master API token has access to all the functionalities of secondary API tokens, in addition to managing all the API tokens. The maximum number of secondary API tokens you can manage is 10. This means you can have up to 11 API tokens including the master API token.

    Note: It is recommended that you use secondary API tokens when making API calls. This is because using the master API token may accidentally revoke secondary tokens and lead your API calls to not work.


    HTTP request

    POST https://api-{application_id}.sendbird.com/v3/applications/api_tokens
    

    Request body

    The following table lists the properties of an HTTP request that this action supports.

    Required
    Property nameTypeDescription

    HTTP_API_TOKEN

    string

    Specifies the master API token of the application.

    {
        "HTTP_API_TOKEN": "{master_api_token}"
    }
    

    Response

    If successful, this action returns the information about the generated secondary API token in the response body.

    {
        "token": "b3d79100dedf80cf4afdf3de5385b64c3be8cf71",
        "created_at": 1596607063
    }
    

    In the case of an error, an error object is returned. A detailed list of error codes is available here.