Skip to main content
POST
List work items

Restrictions

Usage

  • At least one of incident_id, post_mortem_id, assignee_id, or assignee_type = ai_sre is required.
  • Filtering by incident_id or post_mortem_id requires read access to that incident or report; listing by incident_id also includes follow-ups bound to the incident’s post-mortem when the caller can read it.
  • Listing by assignee_id alone requires being that member or an account owner or admin. Without incident_id and post_mortem_id, callers who are not owner or admin see only items whose incident or report they can read.
  • Sorted by updated_at_seconds descending. Pass the previous response’s next_cursor as cursor until has_more is false.

Authorizations

app_key
string
query
required

APP Key created in the Flashduty console under My → APP Key. Send it as the app_key query parameter or in the Fd-App-Key request header. Its effective access is the intersection of the key's permission scope and the creator's current role permissions. Keep it secret.

Body

application/json

Filters for listing work items. At least one of incident_id, post_mortem_id, assignee_id, or assignee_type = ai_sre is required.

incident_id
string

Incident ID (MongoDB ObjectID). Also returns follow-ups anchored on the incident's post-mortem.

Pattern: ^[0-9a-fA-F]{24}$
post_mortem_id
string

Post-mortem ID (32-character hex string). Returns follow-ups bound to this post-mortem.

item_type
enum<string>

Filter by work item type: action action item, follow_up post-mortem follow-up.

Available options:
action,
follow_up
assignee_id
integer<int64>

Restrict results to items assigned to this member ID. Listing by assignee alone requires being that member or an account owner or admin. Ignored when assignee_type is ai_sre.

assignee_type
enum<string>

Filter by assignee type: person or ai_sre. ai_sre returns items assigned to AI SRE (an AI caller uses this to list its own tasks) and does not require assignee_id. person together with assignee_id restricts results to that member. Omitted with a positive assignee_id means person.

Available options:
person,
ai_sre
cursor
string

Opaque cursor from a previous response's next_cursor. An invalid cursor returns InvalidParameter.

limit
integer<int64>
default:50

Page size. 0, negative or omitted means 50; values above 200 are treated as 200.

Response

Success

Success response envelope. On every 2xx response, request_id identifies the call (also mirrored in the Flashcat-Request-Id header) and data holds the endpoint-specific payload. Failure responses use a different shape — see ErrorResponse.

request_id
string
required

Unique ID for this request. Mirrored in the Flashcat-Request-Id response header. Include it when reporting issues.

Example:

"01HK8XQE3Z7JM2NTFQ5YJ8P9R4"

data
object

Cursor-paginated list of work items.