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}/builds 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/remove-deprecated-endpoints/openapi/openapi.yaml

• Envvars API: https://gitlab.wikimedia.org/repos/cloud/toolforge/envvars-api/-/blob/slavina/remove-deprecated-endpoints/openapi/openapi.yaml

• Jobs API: https://gitlab.wikimedia.org/repos/cloud/toolforge/jobs-api/-/blob/slavina/drop-deprecated-endpoints/openapi/openapi.yaml

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