# Task DOCU-166 - API V3 Spec Improvements

Project: Documentation
Status: closed
URL: https://community.openproject.org/work_packages/DOCU-166

## Details

| Attribute | Value |
| --- | --- |
| Assignee | Community Contributor |
| Date |  |
| Priority | Low |
| Target versions | 12.1.0 |
| Category |  |
| Labels |  |

## Description

The current state of the OpenProject API V3 spec leads to sometimes strange and sometimes just plain wrong generated client code. (Using OpenAPI Generator to generate Java client code.)

I created some pull requests, the modifications in which significantly improve the generated code's quality / usability:

  - <https://github.com/opf/openproject/pull/10175>
  - <https://github.com/opf/openproject/pull/10176>
  - <https://github.com/opf/openproject/pull/10177>
  - <https://github.com/opf/openproject/pull/10178>
  - <https://github.com/opf/openproject/pull/10179>

As these changes cover different aspects of the API / spec, I tried to split it into separate pull requests with different topics - just in case some of theses changes are genuine improvements while in other cases I might have been on the wrong track.

I'm no OpenAPI expert yet, so don't really know what I'm doing here actually... ;)

In any case, guessing from the state of the generated code, there's still lots in the API spec which could/should be improved even with all suggested changes applied.

Please also refer to <https://community.openproject.org/topics/14323> .