# Tag Attachments

This endpoint attaches or detaches a tag to/from a reconciliation. When attaching, if the specified tag does not exist, it will be created and then attached automatically.


Endpoint: PUT /api/v1/tags/attachments
Version: 1.0.0
Security: x-api-key

## Request fields (application/json):

  - `system` (string, required)
    The name of the system receiving the tag (e.g., Reconciliations, Checklists).
    Enum: "RECONCILIATIONS", "CHECKLISTS"

  - `systemId` (string, required)
    The unique identifier for the system designated to receive the tag (e.g., Reconciliation ID, Checklist ID).
    Example: "5e94d5b63f557b001420bbe3"

  - `action` (string, required)
    Specifies whether to attach or detach a tag from the system.
    Enum: "ATTACH", "DETACH"

  - `name` (string, required)
    Name of the tag
    Example: "low_risk"

## Response 400 fields (application/json):

  - `message` (string)
    Reason for the errors related to incorrect tag name
    Example: "Invalid tag name"

  - `name` (string)
    BadRequest
    Example: "BadRequest"

  - `status` (integer)
    The HTTP status code.
    Example: 400

## Response 401 fields (application/json):

  - `message` (string)
    Reason for the error such as incorrect service access, malformed, expired or deactivated token.
    Example: "Invalid token"

  - `name` (string)
    Unauthorized
    Example: "Unauthorized"

  - `status` (integer)
    The HTTP status code.
    Example: 401