Skip to content
Polaris Express Docs

Unlink or reassign an EV card

Use this runbook when a customer hands back an EV card, when a card was linked to the wrong Lago customer, or when you need to move a card under a different parent tag in the hierarchy. The card itself stays in SteVe; only its user mapping and parent relationship change.

Prerequisites

Section titled “Prerequisites”
  • You have operator access to the admin web console.
  • SteVe is reachable. If it isn’t, the edit page falls back to a mapping-only view and the parent picker will be empty.
  • You know the card’s idTag or its ocppTagPk.
  • If you’re reassigning to a different parent, the destination parent already exists and is marked as a meta tag.

Procedure

Section titled “Procedure”

  1. Open the card's detail page

    From Tags in the sidebar, find the card by its idTag or display name and click into it. You should land on /tags/[pk].

  2. Open the edit form

    Click Edit. You’ll be taken to /admin/tags/[tagPk]/edit, titled Edit EV Card.

    The idTag field is read-only — the OCPP identifier can’t be renamed. Everything else (display name, notes, tag type, parent, active flag) is editable.

  3. Reassign the parent (optional)

    To move the card under a different customer or group:

    1. Scroll to the Parent picker.
    2. Pick the new parent from the grid. Only tags flagged as meta tags appear here, and the card itself is excluded from the list.
    3. To detach the card from any parent, clear the selection.

  4. Unlink without reassigning (optional)

    If the card should no longer authorize charging at all:

    1. Clear the parent.
    2. Toggle Active off.

    This leaves the card in SteVe but stops it from starting new sessions.

  5. Save

    Click Save. If you arrived here from the create-card wizard (?next=link), the button reads Continue instead and you’ll be sent on to the link step.

Verify

Section titled “Verify”
  • The card’s detail page at /tags/[pk] shows the new parent (or no parent) and the updated active flag.
  • The audit log shows a tag-edit entry for your operator account.
  • On the next sync run, new sessions on this card attribute to the new Lago customer. Check the sync run feed to confirm the mapping flowed through.

If something goes wrong

Section titled “If something goes wrong”

Audit and reversibility

Section titled “Audit and reversibility”
  • Every save writes an entry to the audit log with the previous and new values for parent, active state, tag type, display name, and notes.
  • To reverse a reassignment, edit the card again and pick the original parent. The idTag never changes, so prior session history stays attached to the card itself.
  • Toggling Active is non-destructive: re-enabling the card restores authorization on the next SteVe sync.
Section titled “Related”