Agents

Bulk start agent sessions (uniform)

Changed on

Starts the same agent on between 1 and 50 issues, with an optional prompt shared by every invocation. Supply numeric issue-ID strings, and a Rovo agent ID. Session-start outcomes are returned inline; the agent's work continues asynchronously.

Permissions required:

post/rest/api/3/agents/bulk/invoke/uniform

Request

  • Base URL
    https://your-domain.atlassian.net
  • URL
    https://your-domain.atlassian.net/rest/api/3/agents/bulk/invoke/uniform
  • Auth
    • HTTP basic
    • or OAuth 2
      Authorization code: https://auth.atlassian.com/authorize
      Token URL: https://auth.atlassian.com/oauth/token scopes: write:jira-work

Request body

agentIdstring required

Rovo agent ID.

clientMutationIdstring uuid required

Caller-supplied UUID.

issueIdsstring[] required

Between 1 and 50 numeric issue-ID strings. IDs must be unique.

userPromptstring nullable

Optional prompt applied to every issue.

Example request

{
  "agentId": "0010fa86-cd74-46eb-a2ee-229a98250b9c"
}

Response

Returned if the request is successful.

alreadyStartedCountinteger

Number of ALREADY_STARTED items.

failedCountinteger

Number of FAILED and IN_DOUBT items.

rateLimitedCountinteger

Number of RATE_LIMITED items.

startedCountinteger

Number of STARTED items.

successboolean

True when startedCount or alreadyStartedCount is greater than zero. Does not indicate that every item succeeded.

Example response

{
  "results": [
    {
      "issueId": "10001"
    }
  ]
}

Changes