Agents

Bulk start agent sessions (batch)

Changed on

Starts agent sessions for a batch of issues, with an agent and optional prompt specified per invocation. You can submit between 1 and 50 invocations in one request, including multiple invocations for the same issue. Supply numeric issue-ID strings and Rovo agent IDs. Session-start outcomes are returned inline; the agent's work continues asynchronously.

Permissions required:

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

Request

  • Base URL
    https://your-domain.atlassian.net
  • URL
    https://your-domain.atlassian.net/rest/api/3/agents/bulk/invoke/batch
  • 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

clientMutationIdstring uuid required

Caller-supplied UUID

Example request

{
  "invocations": [
    {
      "agentId": "0010fa86-cd74-46eb-a2ee-229a98250b9c",
      "issueId": "10001"
    }
  ]
}

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