Content
View differences
Updated by Alexander Coles 4 days ago
Various API questions to settle following <mention class="mention" data-id="75686" data-type="user" data-text="@Attila Dombi">@Attila Dombi</mention> 's feedback on [PR 23271](https://github.com/opf/openproject/pull/23271).
1. **Project-scoped vs unscoped endpoint behaviour**, i.e. `/api/v3/projects/:id/sprints` , `/api/v3/sprints/:id`
1. When scoped, only the goal for that project?
2. When unscoped:
1. all goals for projects where the user can view the sprint?
2. all goals for projects where the user has view\_sprints?
3. no goals without explicit project context?
4. goal for owning project if user can view - otherwise as iii)
2. **Scalar** `**goal**` **vs** `**goals**` **collection**
1. goal: "..." only for project-scoped contexts,
2. goals: \[...\] everywhere,
3. **Goal visibility permission**
1. is sprint goal visibility governed by `view_sprints`, `create_sprints`, `project` membership, or some new/derived rule?
4. **Representation shape**
1. `text`
2. `_links.project` / `_links.workspace` \`\_links.workspace\`
3. maybe `projectId` or `workspaceId`
5. **API write support?**
1. out-of-scope?
1. **Project-scoped vs unscoped endpoint behaviour**, i.e. `/api/v3/projects/:id/sprints` , `/api/v3/sprints/:id`
1. When scoped, only the goal for that project?
2. When unscoped:
1. all goals for projects where the user can view the sprint?
2. all goals for projects where the user has view\_sprints?
3. no goals without explicit project context?
4. goal for owning project if user can view - otherwise as iii)
2. **Scalar** `**goal**` **vs** `**goals**` **collection**
1. goal: "..." only for project-scoped contexts,
2. goals: \[...\] everywhere,
3. **Goal visibility permission**
1. is sprint goal visibility governed by `view_sprints`, `create_sprints`, `project` membership, or some new/derived rule?
4. **Representation shape**
1. `text`
2. `_links.project` / `_links.workspace`
3. maybe `projectId` or `workspaceId`
5. **API write support?**
1. out-of-scope?