@frogbotai/piece-jira works with Jira Cloud through its REST API. Agents create, update, transition and comment on issues; imports page through projects, issues, sprints, history and attachments; polling triggers react to new and changed issues.
Connect Jira
siteUrl. People connect with a pasted Atlassian API token, with Sign in with Atlassian, or either:
oauth and oauth: true to offer tokens only. Atlassian recommends sign-in over pasted tokens, since a token acts with all of its owner’s access.
See factory options for the shared options. Jira Cloud only: Jira Server and Data Center aren’t supported.
Make an API token
- Sign in to Atlassian as the account FrogBot should act as, and open API tokens.
- Choose Create API token, name it, and copy it.
- Connect with that account’s email as
emailand the token asapiToken.
Register an Atlassian OAuth app
- In the Atlassian developer console, choose Create → OAuth 2.0 integration.
- Under Authorization, add OAuth 2.0 (3LO) with the instance’s callback URL:
https://your-app.example.com/api/connections/jira/callback(use your instance slug). - Under Permissions → Jira API, add the classic scopes
read:jira-work,write:jira-workandread:jira-user. For boards and sprints, also add the granular scopesread:board-scope:jira-software,read:sprint:jira-softwareandread:project:jira. - Under Settings, copy the client ID and secret into
oauth. - To let people outside your own Atlassian account sign in, set Distribution to sharing.
siteUrl, or the only one. With several sites and no siteUrl, or no match, the call fails and lists the sites the account can reach.
Actions
Issue actions take an issue key such as
OPS-12, or its numeric id.
Write formatted text
Jira stores rich text, such as descriptions and comments, in its own JSON format, ADF. Every rich-text input takes markdown, and FrogBot converts it:Page through a site
These actions return one page at a time, for imports:limit (1–100, default 50) and cursor, the previous page’s pagination.nextCursor, which is null on the last page. Keep the other inputs the same between pages. Epics are issues whose children point to them through parent, so searchIssues reads them.
Jira errors keep Jira’s messages and status. When Jira rate-limits a request, which a large import can, FrogBot waits for its Retry-After and retries up to 3 times, stopping early if the request is aborted.
Triggers
The issue and comment triggers take an optional
jql filter, such as project = OPS. All nine are polling triggers that check every 5 minutes. The first poll only records where to start, so nothing already in Jira is emitted. Issue polls look 15 minutes past the previous one, since Jira’s search can lag, and skip what they already emitted.
A poll has no signed-in person, so mount it on a separate instance with its own factory auth; the instance in your connection entry throws missing without a signed-in person. Give the instance an API token, ideally for a dedicated Jira account:
assignedToMe watches assignments to it.