Changelog
Apps DocsCommunityNeed Help?
Start typing to search…

New `is_trial_expired` and `is_during_trial` fields on `account`

🏷️ API version: 2026-01

You can now determine a monday.com account's trial status via the API using two new fields on the account object:

  • is_trial_expired: Returns true if the account's trial period has ended
  • is_during_trial: Returns true if the account is currently in a trial period
query {
  account {
    is_during_trial
    is_trial_expired
  }
}

New `membership_kind` argument on `workspaces`

🏷️ API version: 2026-01

You can now filter workspaces by the type of membership relationship the user has with each workspace using the new membership_kind argument.

Use all to return all workspaces the user has access to, or member to return only the workspaces the user is explicitly a member of.

query {
  workspaces(membership_kind: member) {
    id
    name
    kind
    description
  }
}

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 updated_at field on the docs query.

query {
  docs(
    object_ids: [123456789]
    limit: 1
  ) {
    id
    object_id
    settings
    updated_at
    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 
  }
}