Create new field forget request

Erase a profile's email and/or phone while keeping the rest of the profile. For each requested field, Ometria clears the value on the profile. Nothing prevents the same value being added back to this profile later either.

profile_hash is the id of a profile, as returned by GET /profiles/.

Requests are processed asynchronously. A 202 means the request was accepted and queued; poll GET /field-forget/{id} until status is terminal. A request identical to one that is still pending or in_progress and less than 24 hours old returns the existing request's id (still 202) rather than creating a new one, so retries are safe. Once a request has reached a terminal status, a new request for the same profile and fields is accepted again.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Provide the profile_hash of the profile and the fields to erase: email, phone, or both.

Field forget request submission. Identifies one profile by its profile_hash and names the field(s) to erase.

string
required
^[0-9a-f]+-[0-9a-f]{6}-[0-9a-f]{8,}$

The profile hash of the profile to act on, as returned by GET /profiles/.

fields
array of strings
required
length ≥ 1

The field(s) to erase: email, phone, or both. Order does not matter and duplicates are ignored; the request is stored and returned with the fields sorted alphabetically.

fields*
Allowed:

A field that can be forgotten. This list is the set supported by the service and is kept in sync via the service's own spec test.

Responses

403

API key is not authorised to access this resource.

Language
Credentials
Header
LoadingLoading…
Response
Choose an example:
application/json