Authentication

    Authentication to DevRev APIs requires a personal access token (PAT). A PAT is used to uniquely identify a dev user in context of a dev org and can be used by external third-party applications to access DevRev APIs on behalf of the corresponding dev user. A PAT has the same set of privileges that the owner of the PAT has on the DevRev platform.

    For example, a VS Code plugin that pulls issues from the DevRev platform pertaining to a particular dev user will need to rely on that user’s PAT to authenticate the DevRev APIs.

    Generate a Personal Access Token (PAT)#

    1. In the DevRev app, go to the relevant dev org.

    2. Go to DevOrg Settings > Account > Personal Access Token.

    3. Click New token and follow the workflow to create your PAT.

      As the token value is not retrievable later, we recommend using descriptive names for PATs as it can help you differentiate between multiple PATs.

    4. Copy the PAT and store it securely. Once you go to another page, you cannot retrieve this PAT again.

      PAT Generation

    Revoke a Personal Access Token#

    Caution: Once a PAT is revoked, it cannot be restored.

    1. In the DevRev app, go to the relevant dev org.

    2. Go to DevOrg Settings > Account > Personal Access Token.

    3. Click Revoke next to the PAT you wish to revoke.

      You can also click the Revoke all button to revoke all the tokens which you have previously generated.