Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Create a new token with full or restricted access to Tempo APIs. Note that full access tokens apply to current scopes/namespaces.

Note

The token

...

does not automatically grant access to scopes/namespaces that are added after the token is created. You must create a new token to include the new scopes/namespaces.

To create a user API token:

  1. Select Settings (blue star)  in the Tempo sidebar.

  2. Under Data Access, select API Integration.

  3. Click New Token at the upper - right.

  4. In the New Token form, define the access token.

    • Name - Enter a descriptive name for the token.

    • Expiry - Set the expiration time for the token. By default, the access token is valid for 30 days, but you can select a longer expiration time up to a maximum of 5000 days.

    • Define the access scope for the token. You can either have full access to all APIs, or you can define custom access for this token.

  5. When you are done, click Confirm.

  6. The token is created and displayed. We only show your access token when you first generate it in order to make your account more secure. You can click the copy icon to copy the token. If you forget to copy the token, you can regenerate it. This will invalidate the existing token; see Regenerating Tokens below.

  7. When you are done, click Close.

...

  • Worklogs scope

    • Worklogs

    • Work Attributes

  • Teams scope

    • Roles

    • Teams

    • Links

    • Memberships

  • Schemes scope

    • Workload Schemes

    • Holiday Schemes

    • User Schedule

  • Plans scope

    • Plans

    • Programs

  • Periods scope

    • Periods

  • Approvals scope

    • Timesheet Approvals

  • Accounts scope

    • Accounts

    • Categories

    • Category Types

    • Links

    • Customers

  • Financial Manager (Cost Tracker) scope

    • Projects

    • Rates

Regenerating Tokens

As long as a token has not expired, it is possible to regenerate the token. The regenerated token will invalidate the current token and generate a new one with the same access as the previous token. This will revoke access for all integrations that were previously using the token.

...

It is not possible to change the a token’s scope for a token. If you created a token with the wrong access, you need to create a new token.

...