ENJA
Open App ›Dictionary Tools & Image Tools
Dictionary tools allow AI agents to share URLs, Playwright locators, and other selector information. Entries are scoped to the project associated with the access token.
create_dictionary_entry
Input:
| Parameter | Type | Required | Description |
|---|---|---|---|
| key | String | ✓ | Unique key (alphanumeric, underscore, hyphen, dot; max 100 characters). Example: login_email_input |
| value | String | ✓ | Value (Playwright locator or URL recommended). Example: [data-testid="email-input"] |
| description | String | - | Description (max 500 characters) |
| author | String | - | Operator name |
Output: DictionaryEntry
list_dictionary_entries
No input parameters required (returns all entries under the project associated with the access token).
Input:
| Parameter | Type | Required | Description |
|---|---|---|---|
| author | String | - | Operator name |
Output: DictionaryEntry[]
get_dictionary_entry
Input:
| Parameter | Type | Required | Description |
|---|---|---|---|
| key | String | ✓ | Key name of the entry to retrieve |
| author | String | - | Operator name |
Output: DictionaryEntry
update_dictionary_entry
Input:
| Parameter | Type | Required | Description |
|---|---|---|---|
| key | String | ✓ | Key name of the entry to update |
| value | String | ✓ | New value |
| description | String | - | New description |
| author | String | - | Operator name |
Output: DictionaryEntry
upload_test_case_image
Attaches an image (jpg/png) to a test case. Pass Base64-encoded image data. The server validates the MIME type (magic bytes) and size (max 5 MB).
Input:
| Parameter | Type | Required | Description |
|---|---|---|---|
| specId | String | ✓ | Test spec composite ID ({projectId}.{specUuid}) |
| caseNumber | Integer | ✓ | Stable case ID of the test case to attach the image to (integer ≥ 1) |
| imageData | String (Base64) | ✓ | Base64-encoded image data (do not include the data:image/...;base64, prefix) |
| mimeType | String | ✓ | image/jpeg or image/png |
| description | String | - | Image description |
| author | String | - | Operator name |
Output: TestCaseImage
{
"id": "image-uuid",
"testCaseId": "test-case-uuid",
"mimeType": "image/png",
"description": "Screenshot of login screen",
"downloadUrl": "https://cdn.katatan.com/...",
"createdAt": "2026-01-01T00:00:00.000Z"
}