# Upsert Usage Identifier

Upsert Usage Identifier

Endpoint: PATCH /rest/2.0/USAGE_IDENTIFIER
Version: 1.0
Security: JWT

## Header parameters:

  - `sessionId` (string, required)

## Request fields (application/json; charset=utf-8):

  - `brmObjects` (object)

  - `brmObjects.CreatedUserId` (string)
    System controlled field: Id of the user that created the record

  - `brmObjects.Updated` (string)
    System controlled field: Date and time the record was last updated

  - `brmObjects.UpdatedUserId` (string)
    System controlled field: Id of the last user that updated the record

  - `brmObjects.UsageIdentifier` (string, required)
    Usage Identifier:  Usage Identifiers allow you to configure which token is triggered whenever the collector mapping on the usage collector is satisfied. This in turn adds the products that are configured to use this token to the invoice.

  - `brmObjects.Id` (string, required)
    Usage IDentifier ID

  - `brmObjects.Created` (string)
    System controlled field: Date and time the record was created

  - `externalIDFieldName` (string)
    Enum: "UsageIdentifier"

## Response 200 fields (application/json):

  - `upsertResponse` (array)

  - `upsertResponse.Id` (integer)

  - `upsertResponse.success` (boolean)

  - `upsertResponse.ErrorText` (string)

  - `upsertResponse.ErrorElementField` (string)

  - `upsertResponse.created` (boolean)