Durable Functions HTTP API: Response structure mismatch List entities vs Get entity

[jaliyaudagedara]

Currently,

List entities:

GET /runtime/webhooks/durabletask/entities/{entityName}
    ?taskHub={taskHub}
    &connection={connectionName}
    &code={systemKey}
    &lastOperationTimeFrom={timestamp}
    &lastOperationTimeTo={timestamp}
    &fetchState=[true|false]
    &top={integer}

Say, we are passing fetchState=true in the QueryString.

The response looks like something like below:

[
  {
    "entityId": {
      "name": "someEntityName",
      "key": "0002f3c57ec845cea5096d026cb4f895"
    },
    "lastOperationTime": "2025-10-21T17:34:06.9945586Z",
    "state": {
        "prop1": "value1",
        "prop2": "value2",
    }
  },
  {
    "entityId": {
      "name": "someEntityName",
      "key": "0004d73c2bdf4e86a4d56c31d222717c"
    },
    "lastOperationTime": "2025-08-21T15:05:26.2092795Z",
    "state": {
        "prop1": "value1",
        "prop2": "value2",
    }
  },
  ....
 ]

Get entity:

GET /runtime/webhooks/durabletask/entities/{entityName}/{entityKey}
    ?taskHub={taskHub}
    &connection={connectionName}
    &code={systemKey}

The response looks like something like below,

{
  "prop1": "value1",
  "prop2": "value2",
}

Note: Only the state being returned.

From the REST perpective, shouldn't this return the entire Resource,

{
  "entityId": {
    "name": "someEntityName",
    "key": "0004d73c2bdf4e86a4d56c31d222717c"
  },
  "lastOperationTime": "2025-08-21T15:05:26.2092795Z",
  "state": {
     "prop1": "value1",
     "prop2": "value2",
  }
}

[jaliyaudagedara]

@lilyjma FYI