Skip to main content

get_containers

Get all containers (projects/services) with their areas. This is typically the first tool to call — container IDs are required by most other tools including filter_items, get_container_process_list, and create_item.
Property
Read-onlyYes

Parameters

None.

Returns

A list of ContainerDto objects, each containing:
  • containerId, containerCode, containerName, containerDesc — container identity
  • url — direct link to the container in the Ekso web app
  • areas — list of areas with ID, name, and description

get_container_process_list

Get the processes configured for a specific container, along with their fields.
Property
Read-onlyYes

Parameters

ParameterTypeRequiredDescription
containerIdstringYesContainer ID.

Returns

A list of ContainerProcessDto objects with process ID, name, and field names. Use the returned processId when calling create_item.

filter_items

Filter and page through work items using condition groups. Each group contains AND conditions; groups are OR-ed together. If no conditions are provided, returns all open items in the specified containers. Results are paginated at 200 items per page, sorted by last changed date (most recent first).
Property
Read-onlyYes

Parameters

ParameterTypeRequiredDefaultDescription
containerIdsstring[]YesContainer IDs to search within. Use get_containers.
conditionsJsonstringNonullFilter conditions as JSON (see format below). Omit for all items.
includeClosedboolNofalseInclude closed items.
pageintNo1Page number (200 items per page).

Condition format

[
  {
    "condition": [
      {
        "leftSide": "<fieldId>",
        "operator": "Equal",
        "rightSide": "<value>"
      }
    ]
  }
]
  • Within a group: conditions are combined with AND (all must match)
  • Between groups: groups are combined with OR (any group can match)
Operators:
NameNumericDescriptionApplicable types
Equal10Exact matchAll types
NotEqual11Does not matchAll types
LessThanOrEqual20Less than or equal toInteger, Decimal, Percent, Date, Time
LessThan21Strictly less thanInteger, Decimal, Percent, Date, Time
GreaterThanOrEqual30Greater than or equal toInteger, Decimal, Percent, Date, Time
GreaterThan31Strictly greater thanInteger, Decimal, Percent, Date, Time
Contains40Substring matchText
StartsWith41Prefix matchText
EndsWith42Suffix matchText
Operator values are case-insensitive — "Equal", "equal", and 10 all work. Use get_filter_fields to discover filterable fields, valid operators, and value format guidance. Use get_field_list_data to get valid IDs for list-type fields (Status, Priority, Severity, etc.).

Returns

An ItemFilterResultDto containing:
PropertyDescription
itemsList of CycleItemDto objects for the current page
totalTotal number of matching items across all pages
pageCurrent page number
pagesTotal number of pages
pageSizeItems per page (200)