Apply Tag

View as Markdown

Headers

{{tenant_key_name}}stringOptional

Request

This endpoint expects a multipart form.
entity_idstringRequired

Required: Entity UUID - resolved against the field configured in tags.entity_uuid_fields

entity_typestringRequired

Required: Entity type key - in: customer|customer_location|work_order|equipment|lead|opportunity (extensible via config/tags.php entity_mapping)

source_namestringRequired

Optional: Free-text source identifier - max 100 chars - e.g. automation rule name

source_typestringRequired

Optional: Source - in: manual|automation|integration|system - default manual

tag_type_idstringRequired

Required: Tag type UUID - resolved by ConvertUuidToId middleware

source_referencestringRequired

Optional: Free-text external reference - max 191 chars - e.g. integration sync ID

Response

Successful response