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 <sstefan...@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/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
> _______________________________________________
> Cloud-announce mailing list -- cloud-annou...@lists.wikimedia.org
> List information:
> https://lists.wikimedia.org/postorius/lists/cloud-announce.lists.wikimedia.org/
>
_______________________________________________
Cloud mailing list -- cloud@lists.wikimedia.org
List information: 
https://lists.wikimedia.org/postorius/lists/cloud.lists.wikimedia.org/

Reply via email to