Skip to main content
PUT
/
events
/
{request_id}
Node SDK
// Install: npm install @fingerprintjs/fingerprintjs-pro-server-api
import {
  FingerprintJsServerApiClient,
  RequestError,
  Region,
} from '@fingerprintjs/fingerprintjs-pro-server-api'

const client = new FingerprintJsServerApiClient({
  apiKey: 'SERVER_API_KEY', // Replace with your key
  region: Region.Global, // Replace with your region
})

const requestId = 'REQUEST_ID' // Replace with your request ID

// Update an event
try {
  await client.updateEvent(
    {
      tag: {
        key: 'value',
      },
      linkedId: 'new_linked_id',
      suspect: false,
    },
    requestId
  )

  console.log('Event updated')
} catch (error) {
  if (error instanceof RequestError) {
    console.log(`error ${error.statusCode}: `, error.message)
    console.log(error.response.statusText)
  } else {
    console.log('unknown error: ', error)
  }
}
Deprecation NoticeThis version of Server API is marked as deprecated starting on Oct 31st 2025 and will be fully removed on Oct 31st 2026 according to our API Deprecation Policy. If you still use this version, please follow our migration guide to migrate from this deprecated version to the new one.
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.

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.