Hi,
If you do not use the raw Toolforge APIs directly, you can ignore this message.
As we are moving toward stable API versions for the three Toolforge APIs (jobs, builds, envvars), we are further consolidating the API paths. The following backward-incompatible changes will take effect next Tuesday July 23 at 12:00 UTC:
- The /api prefix will be dropped from jobs API, e.g. /v1/tool/<toolname>/jobs/ instead of */api*/v1/tool/<toolname>/jobs/
- All api resources will be in plural instead of singular, e.g. /v1/tool/{toolname}/build*s* instead of /v1/tool/{toolname}/build
The new API docs can be seen here:
- Builds API: https://gitlab.wikimedia.org/repos/cloud/toolforge/builds-api/-/blob/slavina...
- Envvars API: https://gitlab.wikimedia.org/repos/cloud/toolforge/envvars-api/-/blob/slavin...
- Jobs API: https://gitlab.wikimedia.org/repos/cloud/toolforge/jobs-api/-/blob/slavina/d...
While these APIs are not officially supported (use at your own risk), we are happy to assist if you need help or more time for the transition. Thank you for your understanding as we work to improve our services.
Best,
Slavina on behalf of the Cloud Services team
-- Slavina Stefanova (she/her) Software Engineer | Developer Experience
Wikimedia Foundation
_______________________________________________ Cloud-announce mailing list -- cloud-announce@lists.wikimedia.org List information: https://lists.wikimedia.org/postorius/lists/cloud-announce.lists.wikimedia.o...
Quick note,
For a consolidated view of the API endpoints, you can check https://api-docs.toolforge.org (documentation only, you cant really try them directly from that UI).
On Fri, Jul 19, 2024, 11:26 Slavina Stefanova sstefanova@wikimedia.org wrote:
Hi,
If you do not use the raw Toolforge APIs directly, you can ignore this message.
As we are moving toward stable API versions for the three Toolforge APIs (jobs, builds, envvars), we are further consolidating the API paths. The following backward-incompatible changes will take effect next Tuesday July 23 at 12:00 UTC:
- The /api prefix will be dropped from jobs API, e.g. /v1/tool/<toolname>/jobs/
instead of */api*/v1/tool/<toolname>/jobs/
- All api resources will be in plural instead of singular, e.g.
/v1/tool/{toolname}/build*s* instead of /v1/tool/{toolname}/build
The new API docs can be seen here:
- Builds API:
https://gitlab.wikimedia.org/repos/cloud/toolforge/builds-api/-/blob/slavina...
- Envvars API:
https://gitlab.wikimedia.org/repos/cloud/toolforge/envvars-api/-/blob/slavin...
- Jobs API:
https://gitlab.wikimedia.org/repos/cloud/toolforge/jobs-api/-/blob/slavina/d...
While these APIs are not officially supported (use at your own risk), we are happy to assist if you need help or more time for the transition. Thank you for your understanding as we work to improve our services.
Best,
Slavina on behalf of the Cloud Services team
-- Slavina Stefanova (she/her) Software Engineer | Developer Experience
Wikimedia Foundation _______________________________________________ Cloud-announce mailing list -- cloud-announce@lists.wikimedia.org List information: https://lists.wikimedia.org/postorius/lists/cloud-announce.lists.wikimedia.o...