Entitlement

post

https://api.percipio.com/content-discovery/v1/organizations/{orgId}/report-requests/entitlements

Entitlement report provides information on what collection was accessed by whom and when. If the response is not successful, the appropriate error response returns.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

orgId

uuid

required

Organization UUID

Body Params

The configuration to create request handle is supplied in the request body

start

date-time

Start date for events retrieval

end

date-time

End date for events retrieval

timeFrame

string

enum

To calculate the start/end date dynamically based on timeframe and when the report is submitted date. [User can submit an absolute date range (start/end date) or a relative date range (timeframe) but never both]

Allowed:

audience

string

Defaults to ALL

Audience filter, defaults to all

user

string

Defaults to ALL

User UUID to filter by and defaults to all

collection

string

Defaults to ALL

Collection title filter, comma delimited and defaults to all

sort

object

The field to use for sorting and which order to sort in, if sort is not included the results will be returned ascending by collection

sftpId

uuid

SFTP Id associated with OrgId

isFileRequiredInSftp

boolean

Defaults to true

Generated files are required to deliver in the respected sftp location. Default value is true.

zip

boolean

Defaults to false

Generate the reports in zip file format. Default value is false.

encrypt

boolean

Defaults to false

Generate the report file as PGP encrypted file. Default value is false.

isPgpFileExtnNotReqrd

boolean

Defaults to false

If the file that need to be ecncrypted should not include a extension of .pgp at the end of the file name, the value should be set to true. If user sets the value as false or doesn't include the flag a .pgp extension will be appended at the end of file name.

formatType

string

enum

Defaults to JSON

Format Type, defaults to JSON, the value is extracted from Accept attribute in header

Allowed:

fileMask

string

Absolute or masked pattern for the generated report file. Example file masks - fileName_{DD}{MM}{YYYY}, fileName_{ORG_ID}

folderName

string

custom folder under sftp reports wherein the generated report file is to be placed.

includeMillisInFilename

boolean

Defaults to false

Generate files with unix based timestamp. Example - fileName.csv.1561642446608

Responses

400

Bad Request

401

Unauthorized

422

Unprocessable Entity

500

Unexpected error

200Ok

202Accepted