Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.traversal.com/llms.txt

Use this file to discover all available pages before exploring further.

Connecting Confluence allows Traversal to surface runbooks, procedures, and postmortems during investigations and cite relevant internal documentation as evidence.

What Traversal reads

  • Pages — page content searched via CQL and fetched by ID
  • Spaces — space metadata used to scope searches

Required scopes

When issuing a scoped Atlassian API token, grant the following minimum Confluence scopes for optimal agent performance:
ScopeUsed for
search:confluenceCQL search across pages — required for the agent to discover relevant runbooks and docs
read:page:confluenceFetching full page content by ID after a search hit
read:space:confluenceResolving space metadata used to scope searches and label results
read:attachment:confluenceReading attachments referenced from pages
Only search:confluence is needed for the connection health check on the Traversal UI to pass.

Setup

1

Create an Atlassian API token

  1. Open Atlassian API tokens and sign in
  2. Create a standard Atlassian API token, give it a descriptive name, and choose an expiration date
  3. Copy the generated token right away. Atlassian only shows it once
2

Configure in Traversal

Go to Company Knowledge > Integrations, select Confluence, and enter:
  • Confluence site URL (usually https://company.atlassian.net/wiki)
  • Your Atlassian account email
  • API token
Traversal exposes two Confluence authentication modes:
  • Basic Authentication for Atlassian Cloud
  • Bearer Token for self-hosted Confluence Server or Data Center

More information