In the RAP API step 2 initiative, we created an OpenAPI specification for the RAP API endpoints that were created. See https://github.com/opensafely-core/job-runner/blob/main/controller/webapp/api_spec/openapi.yaml as well as a number of very useful tests.
We found the experience very beneficial, we think the RAP API task endpoints would benefit from the same specification.
(Nb. this will probably include revising the task API slightly)
In the RAP API step 2 initiative, we created an OpenAPI specification for the RAP API endpoints that were created. See https://github.com/opensafely-core/job-runner/blob/main/controller/webapp/api_spec/openapi.yaml as well as a number of very useful tests.
We found the experience very beneficial, we think the RAP API task endpoints would benefit from the same specification.
(Nb. this will probably include revising the task API slightly)