Skip to content

jira epic list

  • Usage: jira epic list [flags]

List visible Jira epics using the standard epic JQL for the active profile. Use it when you need epic keys for issue assignment or reporting.

If no Jira profile is configured, the command still returns the JQL and an empty result set so agents can see the intended query shape.

Output fields

With --output json, the response envelope's data object carries these fields. Run jira agent schema for the full machine-readable schema.

Field Type Description
detail boolean
epics[].comments[] object Fields: author, body, created, id, self, updateAuthor, …
epics[].editmeta object Fields: fields
epics[].fields object Fields: assignee, comment, components, created, description, fixVersions, …
epics[].id string
epics[].key string
epics[].linked_issues[] object
epics[].self string
epics[].subtasks[] object
epics[].transitions[] object Fields: hasScreen, id, name
epics[].worklogs[] object Fields: comment, id, started, timeSpentSeconds
jql string

Examples

jira epic list
jira epic list --output=json # (1)!
  1. Return epic keys in a parseable shape