Update an event with a given request ID

curl --request PUT \
  --url https://api.fpjs.io/events/{request_id} \
  --header 'Auth-API-Key: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "linkedId": "<string>",
  "tag": {},
  "suspect": true
}
'

import requests

url = "https://api.fpjs.io/events/{request_id}"

payload = {
    "linkedId": "<string>",
    "tag": {},
    "suspect": True
}
headers = {
    "Auth-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {'Auth-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({linkedId: '<string>', tag: {}, suspect: true})
};

fetch('https://api.fpjs.io/events/{request_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fpjs.io/events/{request_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'linkedId' => '<string>',
    'tag' => [
        
    ],
    'suspect' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Auth-API-Key: <api-key>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.fpjs.io/events/{request_id}"

	payload := strings.NewReader("{\n  \"linkedId\": \"<string>\",\n  \"tag\": {},\n  \"suspect\": true\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("Auth-API-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://api.fpjs.io/events/{request_id}")
  .header("Auth-API-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"linkedId\": \"<string>\",\n  \"tag\": {},\n  \"suspect\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.fpjs.io/events/{request_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Auth-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"linkedId\": \"<string>\",\n  \"tag\": {},\n  \"suspect\": true\n}"

response = http.request(request)
puts response.read_body

Events

Update an event with a given request ID

deprecated

🚧 Deprecation Notice

This version of the API will soon be deprecated under our API Deprecation Policy. The deprecation period will begin once all proxy and library integrations (both backend and frontend) are released. We will continue to provide full support for 12 months from that effective date. This notice will be updated with the official deprecation date once it is set. If you don’t use libraries or proxy integrations, you can use this migration guide to start the transition to the new API today.

Change information in existing events specified by requestId or flag suspicious events.

When an event is created, it is assigned linkedId and tag submitted through the JS agent parameters. This information might not be available on the client so the Server API allows for updating the attributes after the fact.

Warning It’s not possible to update events older than 10 days.

PUT

events

{request_id}

Update an event with a given request ID

curl --request PUT \
  --url https://api.fpjs.io/events/{request_id} \
  --header 'Auth-API-Key: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "linkedId": "<string>",
  "tag": {},
  "suspect": true
}
'

import requests

url = "https://api.fpjs.io/events/{request_id}"

payload = {
    "linkedId": "<string>",
    "tag": {},
    "suspect": True
}
headers = {
    "Auth-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {'Auth-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({linkedId: '<string>', tag: {}, suspect: true})
};

fetch('https://api.fpjs.io/events/{request_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fpjs.io/events/{request_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'linkedId' => '<string>',
    'tag' => [
        
    ],
    'suspect' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Auth-API-Key: <api-key>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.fpjs.io/events/{request_id}"

	payload := strings.NewReader("{\n  \"linkedId\": \"<string>\",\n  \"tag\": {},\n  \"suspect\": true\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("Auth-API-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://api.fpjs.io/events/{request_id}")
  .header("Auth-API-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"linkedId\": \"<string>\",\n  \"tag\": {},\n  \"suspect\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.fpjs.io/events/{request_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Auth-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"linkedId\": \"<string>\",\n  \"tag\": {},\n  \"suspect\": true\n}"

response = http.request(request)
puts response.read_body

Change information in existing events specified by requestId or flag suspicious events. When an event is created, it is assigned linkedId and tag submitted through the JavaScript agent parameters. This information might not be available on the client so the Server API allows for updating the attributes after the fact. Warning It’s not possible to update events older than 10 days.

Authorizations

Auth-API-Key

string

header

required

Path Parameters

request_id

string

required

The unique event identifier.

Body

application/json

linkedId

string

LinkedID value to assign to the existing event

tag

object

A customer-provided value or an object that was sent with identification request.

suspect

boolean

Suspect flag indicating observed suspicious or fraudulent event

Response

OK.

JavaScript Agent

Server API

Policy and Upgrades

Webhooks

Device Reputation Network API

Management API

Server SDKs

Update an event with a given request ID

Authorizations

Path Parameters

Body

Response