teamgroups api list and create team openapi spec - #1204
Conversation
| post: | ||
| $ref: "resources/organizations/organizations_create_team.yml" | ||
|
|
||
| /v2/organizations/teams: |
There was a problem hiding this comment.
The create path /v2/organizations/team is singular while the list path /v2/organizations/teams is plural. Can you confirm this matches the backend API?
There was a problem hiding this comment.
yes, this matches the backend api
| $ref: "resources/organizations/organizations_create_team.yml" | ||
|
|
||
| /v2/organizations/teams: | ||
| get: |
There was a problem hiding this comment.
This list endpoint has no page/per_page params and the response doesn't use the standard allOf + shared/pages.yml#/pagination + shared/meta.yml pagination pattern. Is the collection intentionally unpaginated? If not, please add pagination for consistency with other list endpoints.
There was a problem hiding this comment.
these backends are not paginated at the moment, i will look into adding pagination quickly
| properties: | ||
| id: | ||
| type: integer | ||
| format: uint64 |
There was a problem hiding this comment.
If status and team_invitation.role have a fixed set of backend values, adding an enum (like team_invitation_status) would make the docs clearer.
2 participants
adds openapi spec for new teamgroup/organization endpoints