docs icon indicating copy to clipboard operation
docs copied to clipboard

Device Credentials Docs not aligned with API output

Open cv711 opened this issue 3 years ago • 0 comments

Description

for the GET /api/v2/device-credentials API:

  • last_used field appears in response but it's undocumented
  • device_id appears in the documentation but not in the API response
  • rotating_refresh_token type is missing from the field description on the right side column

for the POST /api/v2/device-credentials API:

  • description is wrong and identical to the one above

Also about the pagination behavior for the device-credentials API: There is this line Note: Device Credentials APIs are designed for ad-hoc administrative use only, and paging is by default enabled. but at the top of the docs the per_page parameter is mentioned: per_page: Number of results per page. Paging is disabled if parameter not sent. Can we get a clarification on which one is true?

cv711 avatar Jan 11 '22 11:01 cv711