A bug represents an issue found during use or testing that should be fixed.
Bug attributes
| Field | Type | Description |
|---|---|---|
title | string | The title of the bug. |
handle | string | A unique identifier for the bug, shown in the Atono application as the item ID (e.g., BUG-123). |
position | integer | The bug’s vertical order within its current workflow step, where 0 is the topmost item. Position is relative to the step and team backlog. |
content | array of content chunks | A description of the bug, including a summary, reproduction steps, and expected and actual behavior. Each chunk must include a type and value. Supports DISPLAY_HTML (HTML-formatted content) or TEXT (plain text). |
cycleTimeMode | string | Indicates whether the bug is marked as an OUTLIER (excluded) or remains NORMAL (included) in average cycle time calculations, reports, and staleness indicators. |
stalenessIndicatorSnoozeUntil | datetime (ISO 8601) | The date and time until which the staleness indicator is hidden for this bug in its current step and team backlog. Once the date passes, the indicator is shown again if the bug is still stale. |
createdAt | datetime (ISO 8601) | The date and time the bug was created. |
updatedAt | datetime (ISO 8601) | The date and time the bug was last updated. |
doneAt | datetime (ISO 8601) | The date and time when the bug was completed. |
deleted | boolean | Whether the bug has been deleted. |
Bug relationships
By default, only the type and id of each related resource are returned. To retrieve full details, use the ?include={relationship} query parameter.
| Field | Type | Description |
|---|---|---|
assignee | user | The user assigned to the bug. Use ?include=assignee to retrieve full details. |
team | team | The team backlog the bug is assigned to. Use ?include=team to retrieve full details. |
reporter | user | The user who reported the story. Use ?include=reporter to retrieve full details. |
Example JSON for bug
bug{
"data": {
"type": "bug",
"id": "f239bdd6-9016-4922-a229-b4120aadba15",
"attributes": {
"title": "MIDI input not detected after changing external controllers (Error code: MIDI-202)",
"handle": "BUG-4",
"position": 0,
"content": [
{
"type": "DISPLAY_HTML",
"value": "<h3>Summary</h3><p>When switching between two external MIDI controllers in the Virtual Vintage Synth app, the MIDI input is not detected by the app, and an error code \"MIDI-202\" is shown, requiring a restart to resolve the issue.</p><h3>Reproduction Steps</h3><ol><li><p>Open the Virtual Vintage Synth app.</p></li><li><p>Connect external MIDI controller A and verify it works by playing notes.</p></li><li><p>Disconnect MIDI controller A and connect external MIDI controller B.</p></li><li><p>Try to play notes using MIDI controller B.</p></li><li><p>Adding another AC so this story is updated.</p></li></ol><h3>Expected Behavior</h3><p>The app should recognize and accept input from MIDI controller B without requiring a restart.</p><h3>Actual Behavior</h3><p>The app does not detect any MIDI input from controller B and displays the error code \"MIDI-202.\" A restart is necessary for the app to register the new controller.</p>"
}
],
"cycleTimeMode": "NORMAL",
"createdAt": "2024-09-04T22:28:31Z",
"updatedAt": "2025-06-24T03:37:37Z",
"deleted": false
},
"relationships": {
"assignee": {
"links": {
"related": "/api/v1/users/fe4641d7-c72a-4165-904d-89b2ded40916"
},
"data": {
"type": "user",
"id": "fe4641d7-c72a-4165-904d-89b2ded40916"
}
},
"team": {
"links": {
"related": "/api/v1/teams/0cd0c8b8-734f-4c17-a07c-e993b04af480"
},
"data": {
"type": "team",
"id": "0cd0c8b8-734f-4c17-a07c-e993b04af480"
}
},
"reporter": {
"links": {
"related": "/api/v1/users/2edaca9f-b07e-4af1-b425-1f0b6bf69c0a"
},
"data": {
"type": "user",
"id": "2edaca9f-b07e-4af1-b425-1f0b6bf69c0a"
}
}
}
},
"included": [
{
"type": "team",
"id": "0cd0c8b8-734f-4c17-a07c-e993b04af480",
"attributes": {
"name": "Synth Support Squad",
"description": "Engineering team responsible for maintaining, optimizing, and enhancing our virtual synthesizer. They ensure smooth operation and implement new features while providing top-notch user support...",
"createdAt": "2024-07-18T22:49:52Z",
"updatedAt": "2025-02-07T05:52:49Z",
"isPublic": true,
"backlogManagementByOwners": false
},
"relationships": {
"members": {
"links": {
"self": "/api/v1/teams/0cd0c8b8-734f-4c17-a07c-e993b04af480/relationships/members"
},
"data": [
{
"type": "user",
"id": "2edaca9f-b07e-4af1-b425-1f0b6bf69c0a"
},
{
"type": "user",
"id": "bf60edfc-be09-4fea-8597-33c5b333ce05"
},
{
"type": "user",
"id": "fe4641d7-c72a-4165-904d-89b2ded40916"
},
{
"type": "user",
"id": "a0215837-3d34-4e0b-9796-2ec4d8aa9573"
}
],
"meta": {
"count": 4
}
}
}
},
{
"type": "user",
"id": "fe4641d7-c72a-4165-904d-89b2ded40916",
"attributes": {
"createdAt": "2024-08-10T00:45:55Z",
"updatedAt": "2024-08-10T00:46:58Z",
"invitedAt": "2025-01-23T22:58:21Z",
"email": "[email protected]",
"fullName": "Oliver Resonance",
"deleted": false
}
},
{
"type": "user",
"id": "2edaca9f-b07e-4af1-b425-1f0b6bf69c0a",
"attributes": {
"createdAt": "2024-08-10T00:45:56Z",
"updatedAt": "2025-06-10T23:34:40Z",
"invitedAt": "2025-01-23T22:58:21Z",
"email": "[email protected]",
"fullName": "Ella Rhythm",
"deleted": false
}
}
]
}