Changelog
Apps DocsCommunityNeed Help?
Start typing to search…

New `created_at` field on `account`

🏷️ API version: 2026-01

You can now retrieve an account's creation date using the new created_at field on account queries.

query {
  account {
    id
    show_timeline_weekends
    tier 
    slug
    created_at
    plan {
      period
    }
  }
}

New `width` argument on `update_column` mutation

🏷️ API version: 2026-01

You can now specify a column’s width using the update_column mutation.

mutation {
  update_column(
    board_id: 1234567890
    id: "status"
    title: "Work Status"
    description: "This is my updated work status column"
    column_type: status
    width: 200
    revision: "a73d19e54f82c0b7d1e348f5ac92b6de"
  ) {
    id
    title
    description
  }
}

New `updated_at` field

🏷️ API version: 2026-01

You can now retrieve a monday workdoc's last updated date using the new last_updated field on the docs query.

query {
  docs(
    object_ids: [123456789]
    limit: 1
  ) {
    id
    object_id
    settings
    last_updated
    created_by {
      id
      name
    }
  }
}

New `max_units` field

🏷️ API version: 2026-01

You can now retrieve the maximum number of units for each of your app’s subscriptions using the new max_units field on the app_subscriptions query.

query {
  app_subscriptions(
    app_id: 1234567890
	) {
    cursor
    total_count 
    subscriptions {
      account_id
      monthly_price
      currency
			max_units
    }
  }
}

New `aggregate` object

🏷️ API version: 2026-01

You can now query aggregate to return board data using groupings and aggregation functions via the API.

query {
  aggregate(query: {
    from: { type: TABLE, id: 1234567890 },
    group_by: [{ column_id: "task_owner", limit: 10 }],
    limit: 2,
    query: {
      rules: [{
        operator: any_of,
        column_id: "status",
        compare_value: "done_labels"
      }]
    },
    select: [
      {
        type: FUNCTION,
        function: {
          function: SUM,
          params: [{ type: COLUMN, column: { column_id: "task_estimation" } }]
        },
        as: "sum"
      },
      {
        type: COLUMN,
        column: { column_id: "task_owner" },
        as: "task_owner"
      }
    ]
  }) {
    results {
      entries {
        alias
        value {
          ... on AggregateGroupByResult { value_string }
          ... on AggregateBasicAggregationResult { result }
        }
      }
    }
  }
}

New `export_markdown_from_doc` object

🏷️ API version: 2025-10

You can now query export_markdown_from_doc to return a specific document’s content, or selected blocks, as Markdown via the API.

query {
  export_markdown_from_doc(
    docId: 12345, 
    blockIds: ["e4b1c79a-5f2d-4c83-b1a7-0f9e2d6c3a58", "3a7f2c18-91d4-4b6e-a3f2-7c9e12b4d5a6"]
  ){
    error
    markdown
    success
  }
}

New mutations to update dropdown and status columns

🏷️ API version: 2025-10

We've added two new mutations to update status and dropdown columns. These mutations are strongly typed to better validate complex settings.

mutation {
  update_status_column(
    board_id: 1234567890,
    id: "project_status",
    title: "Updated Project Status",
    revision: "09606bfd3334eb88084f310fb4aef0cb",
    settings: {
      labels: [
        { color: peach, label: "On Hold", index: 1, is_deactivated: true},
        { color: river, label: "Done", index: 2},
        { color: grass_green, label: "Working On It", index: 3}
      ]
    },
    description: "The project's updated status."
  ) {
    description
    id
  }
}
mutation {
  update_dropdown_column(
    board_id: 1234567890,
    id: "project_category",
    title: "Updated Project Category",
    revision: "09606bfd3334eb88084f310fb4aef0cb",
    description: "The project's updated category."
  ) {
    description
    id
    title
  }
}

New `item_nickname` argument on `create_board` mutation

🏷️ API version: 2025-10

When creating a new board via the API, you can now set the item nickname configuration for items on a board using the item_nickname argument.

mutation {
  create_board(
    board_name: "my board",
    board_kind: public,
    item_nickname: { 
      preset_type: "item" 
    }
  ) { 
    id 
  }
}

New mutations to create status and dropdown columns

🏷️ API version: 2025-10

We've added two new mutations to create status and dropdown columns. These mutations are strongly typed to better validate complex settings.

mutation {
  create_dropdown_column(
    board_id: 1234567890,
    id: "project_category",
    title: "Project Category",
    defaults: {
      label_limit_count: 1, 
      limit_select: true,
      labels: [
        {label: "HR"},
        {label: "R&D"},
        {label: "IT"}
      ]
    },
    description: "The project's category."
  ) {
    description
    id
    title
  }
}
mutation {
  create_status_column(
    board_id: 1234567890,
    id: "project_status",
    title: "Project Status",
    defaults: {
      labels: [
        { color: working_orange, label: "On Hold", index: 2},
        { color: done_green, label: "Done", index: 1},
        { color: sky, label: "Working On It", index: 3}
      ]
    },
    description: "The project's status."
  ) {
    description
    id
		title
  }
}