Summary
The Superthread API now documents several Sprint endpoints that weren't available when we first implemented the gem. Our current Sprint support is read-only (list and find). The API now offers full CRUD plus settings management.
Missing Endpoints
| Priority |
Method |
Path |
Description |
| High |
POST |
/{team_id}/sprints |
Create sprint (project_id required, optional title, content) |
| High |
PATCH |
/{team_id}/sprints/{sprint_id} |
Update sprint (title, content, state, start_date, end_date) |
| Low |
GET |
/{team_id}/sprints/settings |
Get sprint settings for a space |
| Low |
PUT |
/{team_id}/sprints/settings |
Update sprint settings (length, cooldown, start day, enabled, layout) |
Sprint Model Gaps
The model is also missing fields the API returns. These should be added regardless of new endpoints — sprints get will immediately show more useful info:
content (description)
state (planned / active / completed / canceled)
end_date
override_end_date
layout (board / list / timeline / calendar)
project_id
unfinished_cards
progress
user_updated
Suggested Approach
- Update the Sprint model with missing fields (quick win)
- Add
create and update to Resources::Sprints + CLI commands
- Sprint settings endpoints can be deferred — admin/config operations most users do in the web UI
API Docs
Summary
The Superthread API now documents several Sprint endpoints that weren't available when we first implemented the gem. Our current Sprint support is read-only (
listandfind). The API now offers full CRUD plus settings management.Missing Endpoints
/{team_id}/sprintsproject_idrequired, optionaltitle,content)/{team_id}/sprints/{sprint_id}title,content,state,start_date,end_date)/{team_id}/sprints/settings/{team_id}/sprints/settingsSprint Model Gaps
The model is also missing fields the API returns. These should be added regardless of new endpoints —
sprints getwill immediately show more useful info:content(description)state(planned/active/completed/canceled)end_dateoverride_end_datelayout(board/list/timeline/calendar)project_idunfinished_cardsprogressuser_updatedSuggested Approach
createandupdatetoResources::Sprints+ CLI commandsAPI Docs