Nuevo Issues

The Issues API can be shared by several programs working from one backlog

Issue updates can now check that nobody changed the issue since you read it, creating an issue or a comment can be retried safely, and lists can show unassigned issues and sort by a Number field.

Programs that use the Issues API together, such as several AI agents working from one team's backlog, no longer get in each other's way.

  • Take an issue without a clash. Every issue now carries an etag, also sent as the ETag header when you read one. Send it back as If-Match when you update the issue, and the update is made only if nobody changed the issue since. If two programs try to take the same issue at once, one succeeds and the other is told it changed (412), with nothing changed.
  • Retry without duplicates. Send an Idempotency-Key header when you create an issue or a comment. If the connection drops and you send the same request again with the same key within 24 hours, you get the first answer back instead of a second issue.
  • Find the next issue. assignee=none lists the issues nobody is assigned to, and sort=field:FIELD_UUID sorts by a Number field, lowest first (-field: for highest first), with issues that have no value last.