Skip to main content

Update an ID tag

PATCH 
/id-tags/:id

Updates general properties of an existing ID tag, including name, assignments, expiry, and status.

Use Cases:

  • Rename tags for better identification
  • Reassign tags to different users or organizations
  • Update expiry dates for renewals or extensions
  • Change authorization status (also see dedicated status endpoint)
  • Remove user assignments while keeping tag active

Important Notes:

  • All fields are optional - only include fields you want to change
  • Setting userId to null transitions tag to PENDING status
  • Setting expiryDate to null removes expiry (tag never expires)
  • Cannot modify tagValue - it's immutable after creation
tip

Use PATCH semantics - only send fields you want to update. Omitted fields remain unchanged.

warning

Changing status from ACTIVE to BLOCKED immediately prevents the tag from authorizing new sessions. Active sessions may continue depending on OCPP configuration.

note

The tagValue field cannot be modified after creation. To change a physical tag identifier, delete the old tag and create a new one.

Request​

Responses​

An ID tag used for charging authentication