API Reference
Apps DocsCommunityNeed Help?

Item ID

Learn how to read the item ID column on monday boards using the platform API

The item ID column represents the unique identifier assigned to each item. You can read the item ID column via the API, but you currently cannot filter, update, or clear it.

You can also read an item's ID by querying id on any field with the Item type.

Read the item ID column

You can query the item ID column using the column_values object that enables you to return column-specific subfields by sending a fragment in your query. Values for the item ID column are of the ItemIdValue type. 

query {
  items (ids:[1234567890, 9876543210]) {
    column_values {
      ... on ItemIdValue {
        value
        text
      }
    }
  }
}

import { ApiClient } from "@mondaydotcomorg/api";
const mondayApiClient = new ApiClient({ token: myToken });

const query = `query($itemIds: [ID!], $columnType:[ColumnType!]) { items (ids:$itemIds) { id column_values (types:$columnType) { column { title id } ... on ItemIdValue { item_id } } } }`;
const variables = {
  itemIds: [9571351485, 9572374902],
  columnType: "item_id"
};

const response = await mondayApiClient.request(query, variables);

Fields

FieldDescription
column Column!The column the value belongs to.
id ID!The column's unique identifier.
item_id ID!The item's unique identifier.
text StringThe column's value as text.
type ColumnType!The column's type.
value JSONThe column's JSON-formatted raw value.

📘

Join our developer community!

We've created a community specifically for our devs where you can search through previous topics to find solutions, ask new questions, hear about new features and updates, and learn tips and tricks from other devs. Come join in on the fun! 😎