KATATANDocs
ENJA
Open App ›
325 words · 2 min read

Label Tools

create_label

Input:

Parameter Type Required Description
workspaceId String (UUID) Workspace ID
name String Label name (max 100 characters, unique within the workspace)
color String gray / red / orange / yellow / green / blue / purple / pink
author String - Operator name

Output: Label


list_labels

Input:

Parameter Type Required Description
workspaceId String (UUID) Workspace ID
author String - Operator name

Output: Label[]


assign_labels_to_test_case

Assigns labels to a test case (full-replacement). Pass labelIds: [] to remove all labels.

Input:

Parameter Type Required Description
specId String Test spec composite ID ({projectId}.{specUuid})
caseNumber Integer Stable case ID (integer ≥ 1)
labelIds String[] Label ID array to assign (empty array removes all labels)
author String - Operator name

Output:

{
  "success": true,
  "specId": "proj-abc.550e8400-...",
  "caseNumber": 3,
  "labelIds": ["label-uuid-1", "label-uuid-2"]
}

delete_label

Deletes a label. Any assignments to test cases are also removed (the TestCaseLabel join table is cascade-deleted). This action cannot be undone.

Input:

Parameter Type Required Description
id String ID of the label to delete
workspaceId String (UUID) Workspace ID
author String - Operator name

Output:

{ "success": true, "id": "label-uuid" }