:PROPERTIES:
:ID:       b129bbc2-43c7-4ba6-bcba-23fcc45add4f
:END:
#+Title: Cisco IROH Client Data Retention
#+Author: Yann Esposito
#+Date: [2024-06-05]

- tags :: 
- source ::

* Recommendation

As a client of XDR API (IROH) you can retrieve the Data Retention policy using
multiple APIs. But the recommended API to use is ~/iroh/profile/whoami~
(See link in TEST: https://visibility.test.iroh.site/iroh/profile/index.html#/Profile/get_iroh_profile_whoami)

You should call this API using an IROH access token that you could retrieve
using the refresh token you should already have for your customer.

Inside this HTTP call, the body of the request should looks like:

#+begin_src javascript
{
  "user": {...},
  "org": {
    ...
    "entitlement-summary": {
      "tier": {"title": "advantage", ...},
      "extra_data_retention": {...},
      "extra_ingest": {...},
      "techvals": {
        "data-retention-in-days": 180,
        "data-maximal-size-in-GB": 30,
        ...
      }
    }
  }
}
#+end_src

The recommended method to retrieve the number of days is to use
~org["entitlement-summary"]["techvals"]["data-retention-in-days"]~ value.
Note for some org the entitlement summary will not be provided entirely as some
XDR org do not have any entitlements (beta orgs, test orgs, not yet sync with
PIAM, etc…)

For these cases we do not provide any default number of day.