Filmo Docs
Español

Incidents

List incidents

Returns the incidents of the account, cursor-paginated: broken, lost or malfunctioning material with its repair status.

Tool
filmo_incidents_list
Access: Read

Result

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "filmo_incidents_list",
    "arguments": {
      "limit": 20
    }
  }
}

generated from the schema

Filter by status, nature, scope, priority, severity, availability impact, affected resource, order, project, assignee, creation date and target resolution date. Sorted by creation date, newest first; sort accepts a single field. Repair costs, resolution notes and whether the cost is charged to the client are not published. Behind the incidence add-on: without it, 402.

Arguments

limitintegerdefault:50

Page size (1-500). Defaults to 50.

Limits: min 1, max 500

cursorstring

Opaque cursor of the page to return. Pass the value of pagination.nextCursor from the previous response; treat it as opaque.

Limits: max length 200

sortstring

Sort order: a single field, with a leading "-" for descending (e.g. "-updatedAt"). Sortable fields: createdAt, updatedAt, dueDate, identifier, title, status, priority. Defaults to "-createdAt". Ties are broken by id, so the order is stable across pages, and a cursor is bound to the sort it was issued with.

Limits: max length 200

statusstring

Filter by lifecycle status: draft, open, waiting, repairing, complete or lost.

Available options: draft, open, waiting, repairing, complete, lost

statusesstring[]

Filter by status, as a list: repeat the parameter or separate the values with commas. Accepts up to 50 values and returns whatever matches any of them.

Available options: draft, open, waiting, repairing, complete, lost

Limits: min 1 items, max 50 items

typestring

Filter by nature: damage, loss, malfunction, cosmetic, theft or custom.

Available options: damage, loss, malfunction, cosmetic, theft, custom

typesstring[]

Filter by type, as a list: repeat the parameter or separate the values with commas. Accepts up to 50 values and returns whatever matches any of them.

Available options: damage, loss, malfunction, cosmetic, theft, custom

Limits: min 1 items, max 50 items

scopestring

Filter by what it affects: item, serializedItem, space, kit, vehicle or custom.

Available options: item, serializedItem, space, kit, vehicle, custom

scopesstring[]

Filter by scope, as a list: repeat the parameter or separate the values with commas. Accepts up to 50 values and returns whatever matches any of them.

Available options: item, serializedItem, space, kit, vehicle, custom

Limits: min 1 items, max 50 items

prioritystring

Filter by priority: urgent, high, medium, low or none.

Available options: urgent, high, medium, low, none

prioritiesstring[]

Filter by priority, as a list: repeat the parameter or separate the values with commas. Accepts up to 50 values and returns whatever matches any of them.

Available options: urgent, high, medium, low, none

Limits: min 1 items, max 50 items

severitystring

Filter by severity: low, high or blocking.

Available options: low, high, blocking

severitiesstring[]

Filter by severity, as a list: repeat the parameter or separate the values with commas. Accepts up to 50 values and returns whatever matches any of them.

Available options: low, high, blocking

Limits: min 1 items, max 50 items

blocksAvailabilityboolean

Filter by availability impact: "true" only incidents that remove the material from the available pool, "false" only those that do not. Omit it to apply no filter.

itemIdstring

Filter by affected item.

Limits: min length 1, max length 100

serializedItemIdstring

Filter by affected physical unit.

Limits: min length 1, max length 100

spaceIdstring

Filter by affected space.

Limits: min length 1, max length 100

vehicleIdstring

Filter by affected vehicle.

Limits: min length 1, max length 100

orderIdstring

Filter by the order in which it was detected.

Limits: min length 1, max length 100

projectIdstring

Filter by associated project.

Limits: min length 1, max length 100

assigneeStaffIdstring

Filter by assigned staff member (the same identifier that assigneeStaffIds takes when writing).

Limits: min length 1, max length 100

includeTotalbooleandefault:false

Set it to true to include pagination.total, the number of results that match the filters across all pages. Off by default.

dateFiltersobject

Date filters by field. A bare day (YYYY-MM-DD) is read in the business timezone; an ISO 8601 instant with offset is applied as is by gte, lte, gt and lt, while on widens it to the whole business day that contains it. Fields: created, due.

Show child attributes
dateFilters.createdobject

Show child attributes
dateFilters.created.gtestring

From this day or instant, inclusive.

dateFilters.created.ltestring

Up to this day or instant, inclusive.

dateFilters.created.gtstring

Strictly after; a bare day means after the end of that day.

dateFilters.created.ltstring

Strictly before; a bare day means before the start of that day.

dateFilters.created.onstring

Exactly that day; an instant means the whole business day that contains it.

dateFilters.dueobject

Show child attributes
dateFilters.due.gtestring

From this day or instant, inclusive.

dateFilters.due.ltestring

Up to this day or instant, inclusive.

dateFilters.due.gtstring

Strictly after; a bare day means after the end of that day.

dateFilters.due.ltstring

Strictly before; a bare day means before the start of that day.

dateFilters.due.onstring

Exactly that day; an instant means the whole business day that contains it.

Result

On success the result carries structuredContent with data and meta. These are the attributes of data.

Show the attributes of data
idstring

Unique incident identifier.

identifierstring

Human-readable incident number.

titlestring

Short title of the incident.

descriptionstring | null

Description; null if it has none.

typestring

Nature: damage, loss, malfunction, cosmetic, theft or custom.

scopestring

What it affects: item, serializedItem, space, kit, vehicle or custom.

Available options: item, serializedItem, space, kit, vehicle, custom

statusstring

Lifecycle status: draft, open, waiting, repairing, complete or lost.

prioritystring

Priority: urgent, high, medium, low or none.

severitystring

Declared severity.

blocksAvailabilityboolean

true when the incident removes the material from the available pool.

affectedQuantityinteger | null

Affected units in bulk stock; null when not applicable.

itemIdstring | null

Affected item; null if not applicable.

serializedItemIdstring | null

Affected physical unit; null if not applicable.

spaceIdstring | null

Affected space; null if not applicable.

vehicleIdstring | null

Affected vehicle; null if not applicable.

orderIdstring | null

Order in which it was detected; null if not applicable.

projectIdstring | null

Associated project; null if not applicable.

dueDatestring<date-time> | null

Target resolution date in ISO 8601 UTC; null if it has none.

commentCountinteger

Comments the incident has.

createdAtstring<date-time>

Creation date in ISO 8601 UTC.

updatedAtstring<date-time>

Last modification date in ISO 8601 UTC.

An error is a result with isError: true and the problem in content[0].text; there is no structuredContent. See Errors.

Sample prompts

List the open incidents and which items they affect.

The same operation by REST

This tool runs GET /api/v1/incidents.

Related pages

Link to this section: Related pages

  • Incidents

    List incidents

    Returns the incidents of the account, cursor-paginated: broken, lost or malfunctioning material with its repair status.

  • Guides

    Safe writes

    An assistant that can write can also write the wrong thing. Decide which tools need a person, retry without duplicating, and know what a write sets in motion.

  • Guides

    Errors

    A tool error is a result with isError: true and the problem in the first text block. Branch on its code.

Was this page helpful?

Cookies

If you accept, we use Google cookies to measure visits and show you ads. Privacy policy

More information

With your consent we use Google Ads and Google Analytics cookies to measure which campaigns bring visitors and requests, and to show you Filmo ads on other sites. Without acceptance, Google receives cookieless measurement signals, including your IP address, browser information and a cleaned page URL. Your choice is shared with the Filmo app.