Add stories to an epic
Bulk-adds backlog items of type STORY to the epic identified by id, up to a maximum of 100 stories per epic. To see the current count, fetch the epic with include=EPIC_STORIES and check relationships.epicStories.meta.count.
Note that id in the path is the epic's id, while each id inside the request body's data array is a story's id.
A story that already belongs to a different epic is moved rather than duplicated, since a story can only belong to one epic at a time. Stories that are already on this epic are left as-is and are not duplicated.
This endpoint applies a best-effort, partial-success model for invalid items: any story in data that is not found, is not of type STORY (e.g. it's a bug or another epic - no nested epics), or belongs to a private team the caller cannot access, is reported in the errors array along with its id and the reason, without blocking the rest of the request. Stories already on this epic are left as-is and don't count as new additions.
Capacity is enforced as all-or-nothing: if adding every valid, not-yet-associated story in data would exceed the 100-story limit, none of them are added, and a single error in errors reports how many stories were requested versus how many could actually fit. (Invalid items such as bugs or non-existent ids don't count toward this limit either way.)
Request
- Base URL: https://api.atono.io
- URL: https://api.atono.io/api/backlog_items/{id}/relationships/epicStories
- Auth: API key in header X-API-KEY
Path parameters
The id of the epic to add stories to.
Request body
Response
At least one story ended up associated with the epic. Returns the full, current list of story ids on the epic (not just the ones just added) in data, plus any failures in errors. meta.addedCount is the number of stories newly associated by this call. meta.errorCount is the number of entries in the errors array (e.g. the 100-story-limit violation is always reported as a single aggregate entry, even though it can reject many stories at once). meta.failedCount is the total number of individual story ids that were rejected across all errors - for the limit-violation error, check that error's meta.ids for the full list of rejected ids.
Changes
No recorded changes to this operation across all 1 revision of this API.