Confluence is in beta. It has been tested against scripted responses written from Atlassian’s
documentation, not yet against a real Confluence site, so tell your MITHUNAI contact if a sync
does not read what you expect.
What you need
- A Confluence Cloud site, at an address like
https://your-company.atlassian.net. Confluence Data Center and sites on your own domain are not supported. - An Atlassian account that can view the spaces you want read. A dedicated account for MITHUNAI is best, so its access is exactly what you choose.
- The owner or admin role in your MITHUNAI organisation.
1. Create the API token in Atlassian
Signed in to Atlassian as the account MITHUNAI will read as:- Go to id.atlassian.com/manage-profile/security/api-tokens.
- Select Create API token. If you see a choice, choose the plain API token, not the one with scopes: MITHUNAI does not support scoped tokens yet.
- Name it so you will recognise it later, such as
MITHUNAI. - Choose an expiration date. Atlassian allows up to one year. Note the date: you will replace the token before then.
- Select Create, then Copy to clipboard.
2. Save it in MITHUNAI
- In the console, open Sources and choose Connect source.
- Choose Confluence.
- You have no Atlassian connection yet, so the form to add one is open. Fill in:
- Connection name: your own name for it, such as
Docs team Confluence. - Site address: your site, such as
https://your-company.atlassian.net. You can paste any page’s address; only the site is kept. It cannot be changed later. - Account email: the email of the Atlassian account the token belongs to.
- Token: the API token you copied.
- Connection name: your own name for it, such as
- Choose Save connection. The token is now stored encrypted and is never shown again.
3. Choose what to read
- Name: what the source is called in your list.
- Spaces: the short code of each space, separated by commas. It is in the space’s address:
…/wiki/spaces/ENG/…isENG. Leave it empty to read every space the account can see. - Maximum pages (under Change filters): from 1 to 5,000, 500 by default.