OrderLineItemTagRules

List all order line item tag rules

GET

https://api.gosmarter.ai

/api/company/{companyId}/order-line-item-tag-rules

Retrieves all order line item tag rules for the specified company, including linked tag information.

List all order line item tag rules › path Parameters

companyId

string · uuid · required

The unique identifier of the company

List all order line item tag rules › Headers

GoSmarter-Api-Key

string · required

The GoSmarter-Api-Key header is used to authenticate with the API using your API key. Value is of the format YOUR_KEY_HERE.

List all order line item tag rules › Responses

List of order line item tag rules

metaOrderLineItemTagRuleDto[]

metaOrderLineItemTagRuleDto

createdAt

string · date-time

Timestamp when the rule was created (UTC)

updatedAt

string · date-time

Timestamp when the rule was last updated (UTC)

tagName

string

Name of the linked tag

tagColor

string

Color of the linked tag

ruleId

string · uuid

Unique identifier for the rule

companyId

string · uuid

Identifier of the owning company

tagId

string · uuid

Tag to assign when rule matches

name

string

Rule name (must be unique within company)

description

string

Optional description

ruleJson

string

JSON representation of the rule logic

isActive

boolean

Whether the rule is active and should be evaluated

active

boolean

Whether the rule exists (false = soft-deleted)

lastModifiedBy

string · uuid

ID of the user who last modified this rule

isSystemRule

boolean

True for rules provisioned by a subscribed Rule Pack — read-only (cannot be edited), but can be deleted

GET/api/company/{companyId}/order-line-item-tag-rules

curl https://api.gosmarter.ai/api/company/:companyId/order-line-item-tag-rules \
  --header 'GoSmarter-Api-Key: <string>' \
  --header 'Authorization: Bearer <token>'

Example Responses

[
  {
    "createdAt": "2024-08-25T15:00:00Z",
    "updatedAt": "2024-08-25T15:00:00Z",
    "tagName": "tagName",
    "tagColor": "tagColor",
    "ruleId": "00000000-0000-0000-0000-000000000000",
    "companyId": "00000000-0000-0000-0000-000000000000",
    "tagId": "00000000-0000-0000-0000-000000000000",
    "name": "name",
    "description": "description",
    "ruleJson": "ruleJson",
    "isActive": true,
    "active": true,
    "lastModifiedBy": "00000000-0000-0000-0000-000000000000",
    "isSystemRule": true
  }
]

json

application/json

Create new order line item tag rule

POST

https://api.gosmarter.ai

/api/company/{companyId}/order-line-item-tag-rules

Creates a new order line item tag rule for the specified company. The rule will be automatically evaluated against existing line items. Returns 409 Conflict if a soft-deleted rule with the same name already exists.

Create new order line item tag rule › path Parameters

companyId

string · uuid · required

The unique identifier of the company

Create new order line item tag rule › Headers

GoSmarter-Api-Key

string · required

The GoSmarter-Api-Key header is used to authenticate with the API using your API key. Value is of the format YOUR_KEY_HERE.

Create new order line item tag rule › Request Body

createOrderLineItemTagRuleDto

tagId

string · uuid

Tag to assign when rule matches

name

string

Rule name (must be unique within company)

description

string

Optional description

ruleJson

string

JSON representation of the rule logic

isActive

boolean

Whether the rule is active and should be evaluated

Create new order line item tag rule › Responses

Rule created successfully

orderLineItemTagRuleDto

ruleId

string · uuid

Unique identifier for the rule

companyId

string · uuid

Identifier of the owning company

tagId

string · uuid

Tag to assign when rule matches

name

string

Rule name (must be unique within company)

description

string

Optional description

ruleJson

string

JSON representation of the rule logic

isActive

boolean

Whether the rule is active and should be evaluated

active

boolean

Whether the rule exists (false = soft-deleted)

lastModifiedBy

string · uuid

ID of the user who last modified this rule

isSystemRule

boolean

True for rules provisioned by a subscribed Rule Pack — read-only (cannot be edited), but can be deleted

POST/api/company/{companyId}/order-line-item-tag-rules

curl https://api.gosmarter.ai/api/company/:companyId/order-line-item-tag-rules \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'GoSmarter-Api-Key: <string>' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "tagId": "00000000-0000-0000-0000-000000000000",
  "name": "name",
  "description": "description",
  "ruleJson": "ruleJson",
  "isActive": true
}'

Example Request Body

{
  "tagId": "00000000-0000-0000-0000-000000000000",
  "name": "name",
  "description": "description",
  "ruleJson": "ruleJson",
  "isActive": true
}

json

Example Responses

{
  "ruleId": "00000000-0000-0000-0000-000000000000",
  "companyId": "00000000-0000-0000-0000-000000000000",
  "tagId": "00000000-0000-0000-0000-000000000000",
  "name": "name",
  "description": "description",
  "ruleJson": "ruleJson",
  "isActive": true,
  "active": true,
  "lastModifiedBy": "00000000-0000-0000-0000-000000000000",
  "isSystemRule": true
}

json

application/json

Get order line item tag rule

GET

https://api.gosmarter.ai

/api/company/{companyId}/order-line-item-tag-rules/{ruleId}

Retrieves a specific order line item tag rule by ID with linked tag information.

Get order line item tag rule › path Parameters

companyId

string · uuid · required

The unique identifier of the company

ruleId

string · uuid · required

The unique identifier of the rule

Get order line item tag rule › Headers

GoSmarter-Api-Key

string · required

The GoSmarter-Api-Key header is used to authenticate with the API using your API key. Value is of the format YOUR_KEY_HERE.

Get order line item tag rule › Responses

The order line item tag rule

metaOrderLineItemTagRuleDto

createdAt

string · date-time

Timestamp when the rule was created (UTC)

updatedAt

string · date-time

Timestamp when the rule was last updated (UTC)

tagName

string

Name of the linked tag

tagColor

string

Color of the linked tag

ruleId

string · uuid

Unique identifier for the rule

companyId

string · uuid

Identifier of the owning company

tagId

string · uuid

Tag to assign when rule matches

name

string

Rule name (must be unique within company)

description

string

Optional description

ruleJson

string

JSON representation of the rule logic

isActive

boolean

Whether the rule is active and should be evaluated

active

boolean

Whether the rule exists (false = soft-deleted)

lastModifiedBy

string · uuid

ID of the user who last modified this rule

isSystemRule

boolean

True for rules provisioned by a subscribed Rule Pack — read-only (cannot be edited), but can be deleted

GET/api/company/{companyId}/order-line-item-tag-rules/{ruleId}

curl https://api.gosmarter.ai/api/company/:companyId/order-line-item-tag-rules/:ruleId \
  --header 'GoSmarter-Api-Key: <string>' \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "createdAt": "2024-08-25T15:00:00Z",
  "updatedAt": "2024-08-25T15:00:00Z",
  "tagName": "tagName",
  "tagColor": "tagColor",
  "ruleId": "00000000-0000-0000-0000-000000000000",
  "companyId": "00000000-0000-0000-0000-000000000000",
  "tagId": "00000000-0000-0000-0000-000000000000",
  "name": "name",
  "description": "description",
  "ruleJson": "ruleJson",
  "isActive": true,
  "active": true,
  "lastModifiedBy": "00000000-0000-0000-0000-000000000000",
  "isSystemRule": true
}

json

application/json

Update order line item tag rule

PUT

https://api.gosmarter.ai

/api/company/{companyId}/order-line-item-tag-rules/{ruleId}

Updates an existing order line item tag rule. The rule will be re-evaluated against all line items.

Update order line item tag rule › path Parameters

companyId

string · uuid · required

The unique identifier of the company

ruleId

string · uuid · required

The unique identifier of the rule

Update order line item tag rule › Headers

GoSmarter-Api-Key

string · required

The GoSmarter-Api-Key header is used to authenticate with the API using your API key. Value is of the format YOUR_KEY_HERE.

Update order line item tag rule › Request Body

createOrderLineItemTagRuleDto

tagId

string · uuid

Tag to assign when rule matches

name

string

Rule name (must be unique within company)

description

string

Optional description

ruleJson

string

JSON representation of the rule logic

isActive

boolean

Whether the rule is active and should be evaluated

Update order line item tag rule › Responses

Rule updated successfully

orderLineItemTagRuleDto

ruleId

string · uuid

Unique identifier for the rule

companyId

string · uuid

Identifier of the owning company

tagId

string · uuid

Tag to assign when rule matches

name

string

Rule name (must be unique within company)

description

string

Optional description

ruleJson

string

JSON representation of the rule logic

isActive

boolean

Whether the rule is active and should be evaluated

active

boolean

Whether the rule exists (false = soft-deleted)

lastModifiedBy

string · uuid

ID of the user who last modified this rule

isSystemRule

boolean

True for rules provisioned by a subscribed Rule Pack — read-only (cannot be edited), but can be deleted

PUT/api/company/{companyId}/order-line-item-tag-rules/{ruleId}

curl https://api.gosmarter.ai/api/company/:companyId/order-line-item-tag-rules/:ruleId \
  --request PUT \
  --header 'Content-Type: application/json' \
  --header 'GoSmarter-Api-Key: <string>' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "tagId": "00000000-0000-0000-0000-000000000000",
  "name": "name",
  "description": "description",
  "ruleJson": "ruleJson",
  "isActive": true
}'

Example Request Body

{
  "tagId": "00000000-0000-0000-0000-000000000000",
  "name": "name",
  "description": "description",
  "ruleJson": "ruleJson",
  "isActive": true
}

json

Example Responses

{
  "ruleId": "00000000-0000-0000-0000-000000000000",
  "companyId": "00000000-0000-0000-0000-000000000000",
  "tagId": "00000000-0000-0000-0000-000000000000",
  "name": "name",
  "description": "description",
  "ruleJson": "ruleJson",
  "isActive": true,
  "active": true,
  "lastModifiedBy": "00000000-0000-0000-0000-000000000000",
  "isSystemRule": true
}

json

application/json

Soft-delete order line item tag rule

DELETE

https://api.gosmarter.ai

/api/company/{companyId}/order-line-item-tag-rules/{ruleId}

Soft-deletes an order line item tag rule. The rule is marked inactive and hidden from the rules list.

Soft-delete order line item tag rule › path Parameters

companyId

string · uuid · required

The unique identifier of the company

ruleId

string · uuid · required

The unique identifier of the rule

Soft-delete order line item tag rule › Headers

GoSmarter-Api-Key

string · required

The GoSmarter-Api-Key header is used to authenticate with the API using your API key. Value is of the format YOUR_KEY_HERE.

Soft-delete order line item tag rule › Responses

Rule soft-deleted successfully

No data returned

Get order line item tag rule change history

GET

https://api.gosmarter.ai

/api/company/{companyId}/order-line-item-tag-rules/{ruleId}/history

Returns the full temporal audit history for an order line item tag rule, most recent changes first.

Get order line item tag rule change history › path Parameters

companyId

string · uuid · required

The unique identifier of the company

ruleId

string · uuid · required

The unique identifier of the rule

Get order line item tag rule change history › Headers

GoSmarter-Api-Key

string · required

The GoSmarter-Api-Key header is used to authenticate with the API using your API key. Value is of the format YOUR_KEY_HERE.

Get order line item tag rule change history › Responses

Audit history returned successfully

auditEventDto[]

auditEventDto

changedAt

string · date-time

changedById

string · uuid

changedByName

string

changeType

string

auditFieldChange[]

entityType

string

entityLabel

string

List deleted order line item tag rules

GET

https://api.gosmarter.ai

/api/company/{companyId}/order-line-item-tag-rules/deleted

Retrieves all soft-deleted order line item tag rules for the specified company.

List deleted order line item tag rules › path Parameters

companyId

string · uuid · required

The unique identifier of the company

List deleted order line item tag rules › Headers

GoSmarter-Api-Key

string · required

The GoSmarter-Api-Key header is used to authenticate with the API using your API key. Value is of the format YOUR_KEY_HERE.

List deleted order line item tag rules › Responses

List of soft-deleted order line item tag rules

metaOrderLineItemTagRuleDto[]

metaOrderLineItemTagRuleDto

createdAt

string · date-time

Timestamp when the rule was created (UTC)

updatedAt

string · date-time

Timestamp when the rule was last updated (UTC)

tagName

string

Name of the linked tag

tagColor

string

Color of the linked tag

ruleId

string · uuid

Unique identifier for the rule

companyId

string · uuid

Identifier of the owning company

tagId

string · uuid

Tag to assign when rule matches

name

string

Rule name (must be unique within company)

description

string

Optional description

ruleJson

string

JSON representation of the rule logic

isActive

boolean

Whether the rule is active and should be evaluated

active

boolean

Whether the rule exists (false = soft-deleted)

lastModifiedBy

string · uuid

ID of the user who last modified this rule

isSystemRule

boolean

True for rules provisioned by a subscribed Rule Pack — read-only (cannot be edited), but can be deleted

GET/api/company/{companyId}/order-line-item-tag-rules/deleted

curl https://api.gosmarter.ai/api/company/:companyId/order-line-item-tag-rules/deleted \
  --header 'GoSmarter-Api-Key: <string>' \
  --header 'Authorization: Bearer <token>'

Example Responses

[
  {
    "createdAt": "2024-08-25T15:00:00Z",
    "updatedAt": "2024-08-25T15:00:00Z",
    "tagName": "tagName",
    "tagColor": "tagColor",
    "ruleId": "00000000-0000-0000-0000-000000000000",
    "companyId": "00000000-0000-0000-0000-000000000000",
    "tagId": "00000000-0000-0000-0000-000000000000",
    "name": "name",
    "description": "description",
    "ruleJson": "ruleJson",
    "isActive": true,
    "active": true,
    "lastModifiedBy": "00000000-0000-0000-0000-000000000000",
    "isSystemRule": true
  }
]

json

application/json

Restore soft-deleted order line item tag rule

POST

https://api.gosmarter.ai

/api/company/{companyId}/order-line-item-tag-rules/{ruleId}/restore

Restores a soft-deleted order line item tag rule and triggers re-evaluation of line item tagging so that matching line items regain the rule-assigned tag.

Restore soft-deleted order line item tag rule › path Parameters

companyId

string · uuid · required

The unique identifier of the company

ruleId

string · uuid · required

The unique identifier of the rule to restore

Restore soft-deleted order line item tag rule › Headers

GoSmarter-Api-Key

string · required

The GoSmarter-Api-Key header is used to authenticate with the API using your API key. Value is of the format YOUR_KEY_HERE.

Restore soft-deleted order line item tag rule › Responses

Rule restored successfully

orderLineItemTagRuleDto

ruleId

string · uuid

Unique identifier for the rule

companyId

string · uuid

Identifier of the owning company

tagId

string · uuid

Tag to assign when rule matches

name

string

Rule name (must be unique within company)

description

string

Optional description

ruleJson

string

JSON representation of the rule logic

isActive

boolean

Whether the rule is active and should be evaluated

active

boolean

Whether the rule exists (false = soft-deleted)

lastModifiedBy

string · uuid

ID of the user who last modified this rule

isSystemRule

boolean

True for rules provisioned by a subscribed Rule Pack — read-only (cannot be edited), but can be deleted

OrderLineItemTags ProductionPlans