Skip to main content

decision_logs/users

The users API provides a convenient way to retrieve user information that is referenced by decision log storage objects. See schema for details of what information decision log objects contain.

URL

GET .../api/v1/decision_logs/users

This form returns a list of names of available user storage objects, each of which can be provided to the second form of this API to retrieve a secure download location (URL):

GET .../api/v1/decision_logs/users/{name}

Where name was previously retrieved using the list call. Note that storage object names must be URL-encoded before using them to retrieve a download location.

Example

The list call to retrieve user object names is:

GET .../api/v1/decision_logs/users

The response would be similar to:

{
"page": {
"next_token": "",
"result_size": 3,
"total_size": 0
},
"results": [
{
"id": "011a88bc-7df9-4d92-ba1f-2ff319e101e1",
"updated_at": "2022-02-02T18:16:33Z"
},
{
"id": "01d1e01e-bf53-419a-9762-17270b1a7328",
"updated_at": "2022-02-02T18:16:33Z"
},
{
"id": "026dc3e3-4406-43c7-9a3e-cba432b0447b",
"updated_at": "2022-02-02T18:16:33Z"
}
]
}

Note the updated_at field, which can be used to avoid retrieving user objects that haven't changed since last retrieved.

Passing one of the resulting names to the retrieval call:

GET .../api/v1/decision_logs/users/011a88bc-7df9-4d92-ba1f-2ff319e101e1

Yields a response similar to:

{
"user": {
"url": "https://storage.googleapis.com/..."
}
}

url can be used to download the object, which is a JSON file, using standard HTTP tools. The URL is signed and valid for 15 minutes.