Skip to content

Documentation: add personal access token documentation#4258

Open
functionzz wants to merge 2 commits into
mozilla:mainfrom
functionzz:pat_setting_docs
Open

Documentation: add personal access token documentation#4258
functionzz wants to merge 2 commits into
mozilla:mainfrom
functionzz:pat_setting_docs

Conversation

@functionzz

Copy link
Copy Markdown
Collaborator

This PR adds documentation for Personal Access Token creation within the settings page.

Fixes #4231.

@functionzz functionzz marked this pull request as ready for review June 24, 2026 20:09
@functionzz functionzz requested a review from flodolo June 24, 2026 22:40

@flodolo flodolo left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Did we document anywhere how privileged PATs are managed (e.g. for pretranslation)?


![LOCALES tab in translation tools](../assets/localizer/users/translation_locales.png "LOCALES tab in translation tools")

### Personal Access Tokens

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
### Personal Access Tokens
### Personal Access Tokens

![LOCALES tab in translation tools](../assets/localizer/users/translation_locales.png "LOCALES tab in translation tools")

### Personal Access Tokens
Users can create Personal Access Tokens (PAT) which are required for accessing all endpoints of the Pontoon [REST API](https://github.com/mozilla/pontoon/blob/main/pontoon/api/README.md).

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Users can create Personal Access Tokens (PAT) which are required for accessing all endpoints of the Pontoon [REST API](https://github.com/mozilla/pontoon/blob/main/pontoon/api/README.md).
Users can create Personal Access Tokens (PAT) which are required for accessing all endpoints of the Pontoon [REST API](https://github.com/mozilla/pontoon/blob/main/pontoon/api/README.md).

Not all of them?

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just pretranslation and user actions.

### Personal Access Tokens
Users can create Personal Access Tokens (PAT) which are required for accessing all endpoints of the Pontoon [REST API](https://github.com/mozilla/pontoon/blob/main/pontoon/api/README.md).

To create a PAT, the user must enter a suitable token name no longer than 32 characters. The generated token is used with the REST API as follows:

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
To create a PAT, the user must enter a suitable token name no longer than 32 characters. The generated token is used with the REST API as follows:
To create a PAT, the user must enter a suitable token name no longer than 32 characters. The generated token can be used with the REST API as follows:

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Document PAT settings

3 participants