Dependencies

Learn how to read the dependencies between items on a board using the platform API

Dependencies connect items on a board, so that one item (the predecessor) relates to another (the dependent item). Use the queries below to read the predecessors of every item on a board, or of a single item, including the dependency type and lag of each one.

To read or update the dependency column value of an item, see the dependency column reference.

🚧

Only available in API versions 2026-07 and later

Queries

Get board dependencies

  • Returns the dependency predecessors of the items on a board, one page at a time
  • Each item includes its predecessor edges with the dependency type and lag
query {
  board_dependencies(board_id: 1234567890, limit: 50, page: 1) {
    total_count
    items {
      item_id
      predecessors {
        source_item_id
        dependency_type
        lag
      }
    }
  }
}

Arguments

ArgumentTypeDescription
board_idID!The unique identifier of the board to get dependencies for.
limitIntThe maximum number of items to return per page. The default is 25 and the maximum is 500.
pageIntThe page number to return, starting from 1. The default is 1.
include_items_without_predecessorsBooleanWhether to include items that have no predecessor dependencies. The default is true.

Fields

FieldTypeDescription
items[ItemDependency!]The items on the current page, with their predecessor edges.
total_countIntThe total number of items across all pages.

For more about this type, see BoardDependencies.

Get item dependency

  • Returns all the dependency predecessors of a specific item
  • Each predecessor edge includes the dependency type and lag
query {
  item_dependency(board_id: 1234567890, item_id: 9876543210) {
    item_id
    predecessors {
      source_item_id
      dependency_type
      lag
    }
  }
}

Arguments

ArgumentTypeDescription
board_idID!The unique identifier of the board containing the item.
item_idID!The unique identifier of the item to get predecessors for.

Fields

FieldTypeDescription
item_idIDThe ID of the item.
predecessors[DependencyEdge!]The predecessor dependency edges of the item.

For more about this type, see ItemDependency.