Genesys Cloud - Developer Community!

 View Only

Sign Up

  • 1.  Workitem Schema Versions (Task Management)

    Posted 06-25-2025 08:42

    Hi,

    The lateset version of the Java Platform Client SDK has methods to get all the versions of a schema declared as e.g.:

      public DataSchema getTaskmanagementWorkitemsSchemaVersions(String schemaId) throws IOException, ApiException {
        return  getTaskmanagementWorkitemsSchemaVersions(createGetTaskmanagementWorkitemsSchemaVersionsRequest(schemaId));
      }

    However, looking at the API explorer, what I assume is the equivalent endpoint (get /api/v2/taskmanagement/workitems/schemas/{schemaId}/versions) returns a list of DataSchema objects - which is what I would expect, tbh, given the name of the function.

    Is the SDK declaration wrong and if so, when could we expect to see it corrected?


    #PlatformAPI
    #PlatformSDK

    ------------------------------
    Austen Jackson
    Software Architect
    ------------------------------


  • 2.  RE: Workitem Schema Versions (Task Management)

    Posted 07-01-2025 05:43

    Hello,

    Sorry for the delay.

    Could you please open a ticket with Genesys Cloud Customer Care to report this issue?

    Indeed, there seems to be an error in this API operation. The Platform API Swagger definition for the GET /api/v2/taskmanagement/workitems/schemas/{schemaId}/versions reports a DataSchema object as response, while it is a paging list of data schemas.

    This endpoint has been incorrectly annotated in the Task Management service.

    NB: The Platform API Swagger definition displayed in API Explorer and which is used for Platform API SDK generation is generated out of annotations in the code for the different services.

    We need a ticket so that support can escalate this to the appropriate engineering team, and so engineering can correct the annotation on this endpoint (you can reference this exchange in your ticket).

    Regards,



    ------------------------------
    Jerome Saint-Marc
    Senior Development Support Engineer
    ------------------------------