Tag Audit Logs API | AppsDelivered Documentation

Get Tag Audit Logs

Retrieve audit logs for tag-related activities including creation, updates, deletions, and assignments to templates/hierarchies.

Endpoint

GET /rest/smartissuetemplates/1.0/tag/audit

Parameters

Parameter	Type	Required	Default	Description
`tagId`	int	No	-	Filter by specific tag ID
`userKey`	string	No	-	Filter by user who performed action
`actionType`	string	No	-	Filter by action type (CREATED, UPDATED, DELETED, ASSIGNED)
`fromDate`	string	No	-	Start date (ISO 8601 format)
`toDate`	string	No	-	End date (ISO 8601 format)
`entityType`	string	No	-	Filter by entity type (TEMPLATE, HIERARCHY)
`limit`	int	No	50	Maximum number of records to return
`offset`	int	No	0	Starting position for pagination

Request Example

curl -X GET \
  "https://your-jira-instance.com/rest/smartissuetemplates/1.0/tag/audit?tagId=501&actionType=TAG_ASSIGNED" \
  -H "Authorization: Basic <base64-credentials>" \
  -H "Accept: application/json"

Response

{
  "auditLogs": [
    {
      "id": 40001,
      "timestamp": "2024-01-20T16:20:00.000Z",
      "actionType": "TAG_ASSIGNED",
      "tagId": 501,
      "tagName": "bug-fix",
      "user": {
        "userKey": "template.admin",
        "displayName": "Template Administrator",
        "emailAddress": "template.admin@company.com"
      },
      "details": {
        "entityType": "TEMPLATE",
        "entityId": 123,
        "entityName": "Bug Report Template",
        "action": "add"
      },
      "relatedEntities": [
        {
          "type": "TEMPLATE",
          "id": 123,
          "name": "Bug Report Template"
        }
      ]
    },
    {
      "id": 40002,
      "timestamp": "2024-01-20T14:15:00.000Z",
      "actionType": "TAG_CREATED",
      "tagId": 501,
      "tagName": "bug-fix",
      "user": {
        "userKey": "admin",
        "displayName": "Administrator",
        "emailAddress": "admin@company.com"
      },
      "details": {
        "tagDescription": "Templates and workflows related to bug fixing",
        "color": "#FF5630",
        "category": "workflow",
        "isPublic": true
      }
    }
  ],
  "totalCount": 28,
  "startAt": 0,
  "maxResults": 50
}

Action Types

TAG_CREATED - Tag creation
TAG_UPDATED - Tag modification
TAG_DELETED - Tag deletion
TAG_ASSIGNED - Tag assigned to template/hierarchy
TAG_UNASSIGNED - Tag removed from template/hierarchy
TAG_BULK_OPERATION - Bulk tag operations

Entity Types

TEMPLATE - Tag assigned to template
HIERARCHY - Tag assigned to hierarchy

Usage Examples

Get all assignments for a specific tag:

GET /rest/smartissuetemplates/1.0/tag/audit?tagId=501&actionType=TAG_ASSIGNED

Get tag assignments to templates only:

GET /rest/smartissuetemplates/1.0/tag/audit?actionType=TAG_ASSIGNED&entityType=TEMPLATE

Get recent tag activity:

GET /rest/smartissuetemplates/1.0/tag/audit?fromDate=2024-01-15T00:00:00.000Z&limit=30

Get all tag operations by user:

GET /rest/smartissuetemplates/1.0/tag/audit?userKey=template.admin&limit=100