Filter Profiles API
Describes Philter's API methods for managing filter profiles.
The Filter Profiles API provides endpoints for retrieving, uploading, and deleting filter profiles.
The curl example commands shown on this page are written assuming Philter has been enabled for SSL. If launched from a cloud marketplace, SSL will be enabled automatically with a self-signed SSL certificate. The example commands also assume API authentication is disabled. See the Settings for more information on SSL and API authentication.
getList Filter Profile Names
get
https://philter:8080/api/profiles
Gets the names of available filter profiles. There are no request parameters.
Request
Response
Request
​
Response
200: OK
The response is a list of filter profile names.
["profile1", "profile2", "profile3"]
Example request:
curl -k https://localhost:8080/api/profiles
getGet a Filter Profile
get
https://philter:8080/api/profiles/{filterProfileName}
Gets the contents of a filter profile.
Request
Response
Request
Path Parameters
filterProfileName
required
string
The name of a filter profile.
Response
200: OK
The contents of the filter profile.
{"name": "just-phone-numbers","ignored": [],"identifiers": {"dictionaries": [],"phoneNumber": {"phoneNumberFilterStrategies": [{"strategy": "REDACT","redactionFormat": "{{{REDACTED-%t}}}"}]}}}
404: Not Found
Returned if the requested filter profile does not exist.
There will be no response content.
Example request:
curl -k https://localhost:8080/api/profiles/my-profile
putUpload a Filter Profile
put
https://philter:8080/api/profiles
Uploads a filter profile to Philter. The filter profile will be created on disk under Philter's directory for storing filter profiles. If a filter profile with the given name already exists its contents will be overwritten by the uploaded profile.
Request
Response
Request
Headers
Content-Type
required
string
The value should be set to
application/json.Body Parameters
required
string
The content of the filter profile.
Response
201: Created
There will be no response.
There will be no response content.
Example request:
curl -k https://localhost:8080/api/profiles -d @profile.json
deleteDelete a Filter Profile
delete
https://philter:8080/api/profiles/{filterProfileName}
Deletes a filter profile from Philter.
Request
Response
Request
Path Parameters
filterProfileName
required
string
The name of a filter profile.
Response
200: OK
There will be no response.
There will be no response content.
404: Not Found
A filter profile with the given name was not found.
There will be no response content.
500: Internal Server Error
The filter profile could not be deleted. Check Philter's log file for more information.
There will be no response content.
Example request:
curl -k https://localhost:8080/api/profiles/exprofile
Last updated 4 months ago