Process Files Uri

Detect entities such as PII, PHI or PCI in the file located at the provided URI using Private AI's entity detection engine. After entity detection, a copy of the file with all entities removed is created and placed in the folder specified by PAI_OUTPUT_FILE_DIR on the local host.

This route is similar to /v3/process/files/base64, but relies on URIs instead of base64-encoded strings. As this route avoids the overhead of base64 encoding, it is more suitable for processing large files and large volumes of data.

This route supports the following content types: application/json, application/msword, application/pdf, application/vnd.ms-excel, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet, application/vnd.openxmlformats-officedocument.wordprocessingml.document, application/xml, audio/m4a, audio/mp3audio/mp4, audio/mpeg, audio/mp4a-latm, audio/wav, audio/x-wav, image/jpeg, image/jpg, image/tiff, message/rfc822, text/csv, text/plain

Request

header Parameters

x-api-key

string (X-Api-Key)

Default:

Request Body schema: application/json
required

uri required	string (Uri) URI of the file to be processed. It must be an accessible file path on the host machine (e.g. /Users/sam/files/file.pdf).
	object (Entity Detection) This section contains a set of parameters to control the PII detection process. All fields have sensible default that can be changed for specific needs.
	object (Pdf Options) Options to process PDF files, such as the rendering quality when each page is turned into an image.
	object (Audio Options) Default: {"bleep_start_padding":0,"bleep_end_padding":0} Options to process audio files, such as the padding to add while redacting audio segments.
project_id	string (Project Id) <= 32 characters ^[a-zA-Z0-9\-_\:]*$ Used to categorize requests for reporting purposes. Limited to alphanumeric characters or the following special characters :_-

Responses

200

Successful Response

422

Validation Error

post/v3/process/files/uri

Request samples

Response samples

application/json

{"result_uri": "string",
"processed_text": "string",
"entities": [{"processed_text": "string",
"text": "string",
"location": {"stt_idx": 0,
"end_idx": 0,
"stt_idx_processed": 0,
"end_idx_processed": 0
},
"best_label": "string",
"labels": {"property1": 0,
"property2": 0
}
}
],
"entities_present": true
}