Supported Atlassian Services
| Service | Authentication | Key Capabilities |
|---|---|---|
| Jira | API Token | Create/update issues, manage projects, track workflows |
| Confluence | API Token | Create/edit pages, manage spaces, search content |
Authentication: API Token
Description
Atlassian integrations use API tokens for authentication. An API token is a secure credential that allows Noxus to access your Atlassian resources without storing your password.When to Use
Ideal For
- Automated issue management
- Documentation workflows
- Project tracking automation
- Team collaboration flows
Characteristics
- Permission Type: User-level API token
- Setup: Generate token in Atlassian account
- Access Scope: Based on user’s permissions
- Best For: Automation and integrations
Authentication Flow
Setup Process
- Generate API Token
- Configure in Noxus
Go to Atlassian Account
Navigate to id.atlassian.com
Jira Integration
Capabilities
Issue Management
Issue Management
Create and Update Issues:
- Create new issues with custom fields
- Update issue status and assignees
- Add comments and attachments
- Link related issues
- Set priority and labels
- Search issues with JQL
- Filter by project, status, assignee
- Get issue details and history
- Track issue changes
Project Operations
Project Operations
Project Management:
- List all accessible projects
- Get project details and configuration
- Access project boards
- Manage project components
- View project workflows
Workflow Automation
Workflow Automation
Automated Workflows:
- Transition issues between statuses
- Assign issues based on criteria
- Create sub-tasks automatically
- Update custom fields
- Sync with external systems
Common Use Cases
- Automated Issue Creation
- Status Sync
- Reporting
Create Jira issues from various sources:
- Support requests → Jira tickets
- Bug reports from forms
- Feature requests from Slack
- Automated task creation
Confluence Integration
Capabilities
Page Management
Page Management
Create and Edit Pages:
- Create pages in any space
- Update page content
- Add labels and metadata
- Manage page hierarchy
- Version tracking
- Read page content
- Export to different formats
- Search across spaces
- Attach files
Space Operations
Space Operations
Space Management:
- List accessible spaces
- Get space details
- Create new spaces (if permissions allow)
- Manage space permissions
- Access space content
Search and Discovery
Search and Discovery
Content Search:
- Search across all spaces
- Filter by space, label, or content type
- Full-text search
- Recently updated content
- Access page metadata
Common Use Cases
- Documentation Generation
- Knowledge Sync
- Content Search
Automatically create documentation:
- API documentation from specs
- Meeting notes from transcripts
- Status reports
- Knowledge base articles
Security Best Practices
API Token Management
- Rotate tokens regularly (every 90-180 days)
- Use separate tokens for different integrations
- Revoke unused tokens
- Monitor token usage
Access Control
- Use accounts with appropriate permissions
- Don’t use admin accounts unless necessary
- Review Jira/Confluence permissions
- Audit automation activities
Troubleshooting
Authentication Failed
Authentication Failed
Possible Causes:
- Invalid API token
- Token expired or revoked
- Incorrect email address
- Wrong site URL
- Generate a new API token
- Verify email matches token owner
- Check site URL format (e.g.,
company.atlassian.net) - Test connection with Atlassian API directly
Permission Denied
Permission Denied
Possible Causes:
- Insufficient Jira/Confluence permissions
- Project/space access restrictions
- Issue type not allowed
- Field restrictions
- Verify user has required permissions
- Check project/space access settings
- Review issue type scheme
- Confirm field permissions
Rate Limit Exceeded
Rate Limit Exceeded
Possible Causes:
- Too many API requests
- Concurrent flow executions
- Bulk operations
- Implement delays between requests
- Use batch operations where available
- Reduce flow execution frequency
- Contact Atlassian about rate limits