MillCertTags

List all mill cert tags

GET

https://api.gosmarter.ai

/api/company/{companyId}/millcert-tags

Retrieves all mill cert tags for the specified company, including usage counts.

List all mill cert tags › path Parameters

companyId

string · uuid · required

The unique identifier of the company

List all mill cert tags › 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 mill cert tags › Responses

List of mill cert tags with usage counts

metaMillCertTagDto[]

metaMillCertTagDto

usageCount

integer · int32

Number of mill certs currently assigned this tag

createdAt

string · date-time

updatedAt

string · date-time

tagId

string · uuid

Unique identifier for the tag

companyId

string · uuid

Identifier of the owning company

name

string

Tag name (must be unique within company)

color

string

Hex color code for the tag

description

string

Optional description

active

boolean

Whether the tag is active (false = soft-deleted)

lastModifiedBy

string · uuid

ID of the user who last modified this tag

isSystemTag

boolean

True for tags provisioned by a subscribed Rule Pack — read-only, managed via subscribe/unsubscribe

severity

string

Rule Pack severity (Block/Flag/Audit) this tag represents; null for company-authored tags

Create new mill cert tag

POST

https://api.gosmarter.ai

/api/company/{companyId}/millcert-tags

Creates a new mill cert tag for the specified company. Returns 409 Conflict if a soft-deleted tag with the same name already exists.

Create new mill cert tag › path Parameters

companyId

string · uuid · required

The unique identifier of the company

Create new mill cert tag › 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 mill cert tag › Request Body

createMillCertTagDto

name

string

Tag name (must be unique within company)

color

string

Hex color code for the tag

description

string

Optional description

severity

string

Severity: null, 'Block', 'Flag', or 'Audit'. Not exclusive to system tags.

Create new mill cert tag › Responses

Tag created successfully

millCertTagDto

tagId

string · uuid

Unique identifier for the tag

companyId

string · uuid

Identifier of the owning company

name

string

Tag name (must be unique within company)

color

string

Hex color code for the tag

description

string

Optional description

active

boolean

Whether the tag is active (false = soft-deleted)

lastModifiedBy

string · uuid

ID of the user who last modified this tag

isSystemTag

boolean

True for tags provisioned by a subscribed Rule Pack — read-only, managed via subscribe/unsubscribe

severity

string

Rule Pack severity (Block/Flag/Audit) this tag represents; null for company-authored tags

POST/api/company/{companyId}/millcert-tags

curl https://api.gosmarter.ai/api/company/:companyId/millcert-tags \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'GoSmarter-Api-Key: <string>' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "name": "name",
  "color": "color",
  "description": "description",
  "severity": "severity"
}'

Example Request Body

{
  "name": "name",
  "color": "color",
  "description": "description",
  "severity": "severity"
}

json

Example Responses

{
  "tagId": "00000000-0000-0000-0000-000000000000",
  "companyId": "00000000-0000-0000-0000-000000000000",
  "name": "name",
  "color": "color",
  "description": "description",
  "active": true,
  "lastModifiedBy": "00000000-0000-0000-0000-000000000000",
  "isSystemTag": true,
  "severity": "severity"
}

json

application/json

Update mill cert tag

PUT

https://api.gosmarter.ai

/api/company/{companyId}/millcert-tags/{tagId}

Updates an existing mill cert tag. Changes to name and color will be reflected everywhere the tag appears.

Update mill cert tag › path Parameters

companyId

string · uuid · required

The unique identifier of the company

tagId

string · uuid · required

The unique identifier of the tag

Update mill cert tag › 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 mill cert tag › Request Body

createMillCertTagDto

name

string

Tag name (must be unique within company)

color

string

Hex color code for the tag

description

string

Optional description

severity

string

Severity: null, 'Block', 'Flag', or 'Audit'. Not exclusive to system tags.

Update mill cert tag › Responses

Tag updated successfully

millCertTagDto

tagId

string · uuid

Unique identifier for the tag

companyId

string · uuid

Identifier of the owning company

name

string

Tag name (must be unique within company)

color

string

Hex color code for the tag

description

string

Optional description

active

boolean

Whether the tag is active (false = soft-deleted)

lastModifiedBy

string · uuid

ID of the user who last modified this tag

isSystemTag

boolean

True for tags provisioned by a subscribed Rule Pack — read-only, managed via subscribe/unsubscribe

severity

string

Rule Pack severity (Block/Flag/Audit) this tag represents; null for company-authored tags

PUT/api/company/{companyId}/millcert-tags/{tagId}

curl https://api.gosmarter.ai/api/company/:companyId/millcert-tags/:tagId \
  --request PUT \
  --header 'Content-Type: application/json' \
  --header 'GoSmarter-Api-Key: <string>' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "name": "name",
  "color": "color",
  "description": "description",
  "severity": "severity"
}'

Example Request Body

{
  "name": "name",
  "color": "color",
  "description": "description",
  "severity": "severity"
}

json

Example Responses

{
  "tagId": "00000000-0000-0000-0000-000000000000",
  "companyId": "00000000-0000-0000-0000-000000000000",
  "name": "name",
  "color": "color",
  "description": "description",
  "active": true,
  "lastModifiedBy": "00000000-0000-0000-0000-000000000000",
  "isSystemTag": true,
  "severity": "severity"
}

json

application/json

Soft-delete mill cert tag

DELETE

https://api.gosmarter.ai

/api/company/{companyId}/millcert-tags/{tagId}

Soft-deletes a mill cert tag. The tag is marked inactive and hidden from the tag list. Deleted tags can be restored via POST /company/{companyId}/millcert-tags/{tagId}/restore.

Soft-delete mill cert tag › path Parameters

companyId

string · uuid · required

The unique identifier of the company

tagId

string · uuid · required

The unique identifier of the tag

Soft-delete mill cert tag › 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 mill cert tag › Responses

Tag soft-deleted successfully

No data returned

Get mill cert tag change history

GET

https://api.gosmarter.ai

/api/company/{companyId}/millcert-tags/{tagId}/history

Returns the full temporal audit history for a mill cert tag, most recent changes first.

Get mill cert tag change history › path Parameters

companyId

string · uuid · required

The unique identifier of the company

tagId

string · uuid · required

The unique identifier of the tag

Get mill cert tag 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 mill cert tag 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 mill cert tags

GET

https://api.gosmarter.ai

/api/company/{companyId}/millcert-tags/deleted

Retrieves all soft-deleted mill cert tags for the specified company.

List deleted mill cert tags › path Parameters

companyId

string · uuid · required

The unique identifier of the company

List deleted mill cert tags › 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 mill cert tags › Responses

List of soft-deleted mill cert tags

metaMillCertTagDto[]

metaMillCertTagDto

usageCount

integer · int32

Number of mill certs currently assigned this tag

createdAt

string · date-time

updatedAt

string · date-time

tagId

string · uuid

Unique identifier for the tag

companyId

string · uuid

Identifier of the owning company

name

string

Tag name (must be unique within company)

color

string

Hex color code for the tag

description

string

Optional description

active

boolean

Whether the tag is active (false = soft-deleted)

lastModifiedBy

string · uuid

ID of the user who last modified this tag

isSystemTag

boolean

True for tags provisioned by a subscribed Rule Pack — read-only, managed via subscribe/unsubscribe

severity

string

Rule Pack severity (Block/Flag/Audit) this tag represents; null for company-authored tags

Restore soft-deleted mill cert tag

POST

https://api.gosmarter.ai

/api/company/{companyId}/millcert-tags/{tagId}/restore

Restores a soft-deleted mill cert tag so it can be used again.

Restore soft-deleted mill cert tag › path Parameters

companyId

string · uuid · required

The unique identifier of the company

tagId

string · uuid · required

The unique identifier of the tag to restore

Restore soft-deleted mill cert tag › 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 mill cert tag › Responses

Tag restored successfully

millCertTagDto

tagId

string · uuid

Unique identifier for the tag

companyId

string · uuid

Identifier of the owning company

name

string

Tag name (must be unique within company)

color

string

Hex color code for the tag

description

string

Optional description

active

boolean

Whether the tag is active (false = soft-deleted)

lastModifiedBy

string · uuid

ID of the user who last modified this tag

isSystemTag

boolean

True for tags provisioned by a subscribed Rule Pack — read-only, managed via subscribe/unsubscribe

severity

string

Rule Pack severity (Block/Flag/Audit) this tag represents; null for company-authored tags

List mill cert tag assignments

GET

https://api.gosmarter.ai

/api/company/{companyId}/millcert-tag-assignments

Returns all tag assignments for mill certifications in the specified company.

List mill cert tag assignments › path Parameters

companyId

string · uuid · required

The unique identifier of the company

List mill cert tag assignments › 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 mill cert tag assignments › Responses

List of tag assignments

millCertTagAssignmentTagDto[]

millCertTagAssignmentTagDto

millCertificationId

string · uuid

The mill certification identifier

tagId

string · uuid

Unique identifier for the tag

companyId

string · uuid

Identifier of the owning company

name

string

Tag name

color

string

Hex color code for the tag

description

string

Optional description of the tag

assignedByRuleId

string · uuid

Rule that assigned this tag (null if manually assigned)

isSystemTag

boolean

True for tags provisioned by a subscribed Rule Pack

severity

string

Rule Pack severity (Block/Flag/Audit) this tag represents; null for company-authored tags

GET

https://api.gosmarter.ai

/api/company/{companyId}/mill-certs/{millCertificationId}/tags

Returns all tag assignments for the specified mill certificate.

companyId

string · uuid · required

The unique identifier of the company

millCertificationId

string · uuid · required

The unique identifier of the mill certificate

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.

Tag assignments for the mill certificate

millCertTagAssignmentTagDto[]

millCertTagAssignmentTagDto

millCertificationId

string · uuid

The mill certification identifier

tagId

string · uuid

Unique identifier for the tag

companyId

string · uuid

Identifier of the owning company

name

string

Tag name

color

string

Hex color code for the tag

description

string

Optional description of the tag

assignedByRuleId

string · uuid

Rule that assigned this tag (null if manually assigned)

isSystemTag

boolean

True for tags provisioned by a subscribed Rule Pack

severity

string

Rule Pack severity (Block/Flag/Audit) this tag represents; null for company-authored tags

Set manual tag assignments

PUT

https://api.gosmarter.ai

/api/company/{companyId}/mill-certs/{millCertificationId}/tags/manual

Replaces all manual tag assignments for a mill certificate with the provided set. Rule-based assignments are not affected. Pass an empty list to clear all manual tags.

Set manual tag assignments › path Parameters

companyId

string · uuid · required

The unique identifier of the company

millCertificationId

string · uuid · required

The unique identifier of the mill certificate

Set manual tag assignments › 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.

Set manual tag assignments › Request Body

setManualTagsRequest

tagIds

string[]

Set manual tag assignments › Responses

Updated manual tag assignments

millCertTagAssignmentDto[]

millCertTagAssignmentDto

assignmentId

string · uuid

Unique identifier for the assignment

millCertificationId

string · uuid

Mill certification identifier

tagId

string · uuid

Tag identifier

assignedByRuleId

string · uuid

Rule that assigned this tag (null if manual)

assignedAt

string · date-time

Timestamp when the tag was assigned (UTC)

PUT/api/company/{companyId}/mill-certs/{millCertificationId}/tags/manual

curl https://api.gosmarter.ai/api/company/:companyId/mill-certs/:millCertificationId/tags/manual \
  --request PUT \
  --header 'Content-Type: application/json' \
  --header 'GoSmarter-Api-Key: <string>' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "tagIds": [
    "00000000-0000-0000-0000-000000000000"
  ]
}'

Example Request Body

{
  "tagIds": [
    "00000000-0000-0000-0000-000000000000"
  ]
}

json

Example Responses

[
  {
    "assignmentId": "00000000-0000-0000-0000-000000000000",
    "millCertificationId": "00000000-0000-0000-0000-000000000000",
    "tagId": "00000000-0000-0000-0000-000000000000",
    "assignedByRuleId": "00000000-0000-0000-0000-000000000000",
    "assignedAt": "2024-08-25T15:00:00Z"
  }
]

json

application/json

MillCertifications MillCertTagRules

MillCertTags

List all mill cert tags

List all mill cert tags › path Parameters

List all mill cert tags › Headers

List all mill cert tags › Responses

Create new mill cert tag

Create new mill cert tag › path Parameters

Create new mill cert tag › Headers

Create new mill cert tag › Request Body

Create new mill cert tag › Responses

Update mill cert tag

Update mill cert tag › path Parameters

Update mill cert tag › Headers

Update mill cert tag › Request Body

Update mill cert tag › Responses

Soft-delete mill cert tag

Soft-delete mill cert tag › path Parameters

Soft-delete mill cert tag › Headers

Soft-delete mill cert tag › Responses

Get mill cert tag change history

Get mill cert tag change history › path Parameters

Get mill cert tag change history › Headers

Get mill cert tag change history › Responses

List deleted mill cert tags

List deleted mill cert tags › path Parameters

List deleted mill cert tags › Headers

List deleted mill cert tags › Responses

Restore soft-deleted mill cert tag

Restore soft-deleted mill cert tag › path Parameters

Restore soft-deleted mill cert tag › Headers

Restore soft-deleted mill cert tag › Responses

List mill cert tag assignments

List mill cert tag assignments › path Parameters

List mill cert tag assignments › Headers

List mill cert tag assignments › Responses

List tag assignments for a mill certificate

List tag assignments for a mill certificate › path Parameters

List tag assignments for a mill certificate › Headers

List tag assignments for a mill certificate › Responses

Set manual tag assignments

Set manual tag assignments › path Parameters

Set manual tag assignments › Headers

Set manual tag assignments › Request Body

Set manual tag assignments › Responses