Jira Setup

devto connects to Jira Cloud via REST API using your email and an API token. This guide walks you through the setup.

Step 1: Get your instance URL

Your Jira instance URL looks like https://your-team.atlassian.net. You can find it in your browser address bar when viewing any Jira page.

Step 2: Generate an API token

• -Go to id.atlassian.com/manage-profile/security/api-tokens
• -Click "Create API token"
• -Give it a label like "devto"
• -Copy the generated token — you will not be able to see it again

Step 3: Run devto init

$ cd ~/my-project
$ devto init
? Provider: Jira
? Instance URL: https://my-team.atlassian.net
? Email: you@example.com
? API Token: ••••••••••••
? Project Key: ENG
✓ Connection verified
✓ Created .devto.json

Permissions required

The API token inherits the permissions of your Jira user account. devto needs:

• -Browse Projects — Read project info, issues, and sprints
• -Create Issues — Create epics, stories, tasks, and subtasks
• -Edit Issues — Update status, assignee, priority, labels, and other fields
• -Delete Issues — Only if you want to use the delete_issue tool
• -Manage Sprints — Create, start, and close sprints
• -Add Comments — Add and delete comments on issues
• -Create Attachments — Upload files to issues
• -Log Work — Log time entries on issues

Most Jira users with a Standard or Admin role have all these permissions by default.

Token security

Your Jira API token is encrypted with AES-256-GCM before being stored in the devto cloud. It is only decrypted server-side when making API calls to Jira on your behalf. The encryption key is stored separately from the database.