API - Corsair

Every monday.api.* operation is listed below with parameter shapes and return types from the plugin Zod schemas.

New to Corsair? See API access, authentication, and error handling.

Boards

Name	Type	Required	Description
`archive_board`	`object`	Yes	—

create

boards.create Create a new board Risk: write

await corsair.monday.api.boards.create({});

Input

Name	Type	Required	Description
`board_name`	`string`	Yes	—
`board_kind`	`public \| private \| share`	No	—
`workspace_id`	`number`	No	—
`template_id`	`number`	No	—

Output

Name	Type	Required	Description
`create_board`	`object`	Yes	—

create_board full type

{
  id: string,
  name?: string
}

delete

boards.delete Permanently delete a board Risk: destructive

await corsair.monday.api.boards.delete({});

Input

Name	Type	Required	Description
`board_id`	`string`	Yes	—

Output

Name	Type	Required	Description
`delete_board`	`object`	Yes	—

delete_board full type

{
  id: string
}

duplicate

boards.duplicate Duplicate a board Risk: write

await corsair.monday.api.boards.duplicate({});

Input

Name	Type	Required	Description
`board_id`	`string`	Yes	—
`duplicate_type`	`duplicate_board_with_structure \| duplicate_board_with_pulses \| duplicate_board_with_pulses_and_updates`	No	—
`board_name`	`string`	No	—
`workspace_id`	`number`	No	—

Output

Name	Type	Required	Description
`duplicate_board`	`object`	Yes	—

duplicate_board full type

{
  board: {
    id: string
  }
}

get

boards.get Get a board by ID with groups and columns Risk: read

await corsair.monday.api.boards.get({});

Input

Name	Type	Required	Description
`board_id`	`string`	Yes	—

Output

Name	Type	Required	Description
`boards`	`object[]`	Yes	—

boards full type

{
  id: string,
  name: string,
  description?: string | null,
  board_kind?: string,
  state?: string,
  workspace_id?: string | number | null,
  groups?: {
    id: string,
    title: string,
    color?: string,
    position?: string,
    archived?: boolean
  }[],
  columns?: {
    id: string,
    title: string,
    type?: string,
    settings_str?: string,
    description?: string | null
  }[]
}[]

list

boards.list List all boards Risk: read

await corsair.monday.api.boards.list({});

Input

Name	Type	Required	Description
`limit`	`number`	No	—
`page`	`number`	No	—
`workspace_ids`	`number[]`	No	—
`board_kind`	`public \| private \| share`	No	—
`state`	`active \| archived \| deleted \| all`	No	—
`order_by`	`created_at \| used_at`	No	—

Output

Name	Type	Required	Description
`boards`	`object[]`	Yes	—

boards full type

{
  id: string,
  name: string,
  description?: string | null,
  board_kind?: string,
  state?: string,
  workspace_id?: string | number | null
}[]

update

boards.update Update a board attribute Risk: write

await corsair.monday.api.boards.update({});

Input

Name	Type	Required	Description
`board_id`	`string`	Yes	—
`board_attribute`	`name \| description \| communication`	Yes	—
`new_value`	`string`	Yes	—

Output

Name	Type	Required	Description
`update_board`	`object`	Yes	—

update_board full type

{
  id: string
}

Columns

changeValue

columns.changeValue Change a column value on an item Risk: write

await corsair.monday.api.columns.changeValue({});

Input

Name	Type	Required	Description
`board_id`	`string`	Yes	—
`item_id`	`string`	Yes	—
`column_id`	`string`	Yes	—
`value`	`string`	Yes	—

Output

Name	Type	Required	Description
`change_column_value`	`object`	Yes	—

change_column_value full type

{
  id: string
}

create

columns.create Create a new column in a board Risk: write

await corsair.monday.api.columns.create({});

Input

Name	Type	Required	Description
`board_id`	`string`	Yes	—
`title`	`string`	Yes	—
`column_type`	`string`	No	—
`description`	`string`	No	—

Output

Name	Type	Required	Description
`create_column`	`object`	Yes	—

create_column full type

{
  id: string,
  title?: string
}

list

columns.list List all columns in a board Risk: read

await corsair.monday.api.columns.list({});

Input

Name	Type	Required	Description
`board_id`	`string`	Yes	—

Output

Name	Type	Required	Description
`boards`	`object[]`	Yes	—

boards full type

{
  columns: {
    id: string,
    title: string,
    type?: string,
    settings_str?: string,
    description?: string | null
  }[]
}[]

Groups

create

groups.create Create a new group in a board Risk: write

await corsair.monday.api.groups.create({});

Input

Name	Type	Required	Description
`board_id`	`string`	Yes	—
`group_name`	`string`	Yes	—
`position`	`string`	No	—

Output

Name	Type	Required	Description
`create_group`	`object`	Yes	—

create_group full type

{
  id: string,
  title?: string
}

delete

groups.delete Delete a group from a board Risk: destructive

await corsair.monday.api.groups.delete({});

Input

Name	Type	Required	Description
`board_id`	`string`	Yes	—
`group_id`	`string`	Yes	—

Output

Name	Type	Required	Description
`delete_group`	`object`	Yes	—

delete_group full type

{
  id: string
}

list

groups.list List all groups in a board Risk: read

await corsair.monday.api.groups.list({});

Input

Name	Type	Required	Description
`board_id`	`string`	Yes	—

Output

Name	Type	Required	Description
`boards`	`object[]`	Yes	—

boards full type

{
  groups: {
    id: string,
    title: string,
    color?: string,
    position?: string,
    archived?: boolean
  }[]
}[]

update

groups.update Update a group attribute Risk: write

await corsair.monday.api.groups.update({});

Input

Name	Type	Required	Description
`board_id`	`string`	Yes	—
`group_id`	`string`	Yes	—
`group_attribute`	`title \| color \| position \| relative_position_before \| relative_position_after`	Yes	—
`new_value`	`string`	Yes	—

Output

Name	Type	Required	Description
`update_group`	`object`	Yes	—

update_group full type

{
  id: string
}

Items

Name	Type	Required	Description
`archive_item`	`object`	Yes	—

create

items.create Create a new item in a board Risk: write

await corsair.monday.api.items.create({});

Input

Name	Type	Required	Description
`board_id`	`string`	Yes	—
`item_name`	`string`	Yes	—
`group_id`	`string`	No	—
`column_values`	`string`	No	—

Output

Name	Type	Required	Description
`create_item`	`object`	Yes	—

create_item full type

{
  id: string,
  name?: string
}

delete

items.delete Permanently delete an item Risk: destructive

await corsair.monday.api.items.delete({});

Input

Name	Type	Required	Description
`item_id`	`string`	Yes	—

Output

Name	Type	Required	Description
`delete_item`	`object`	Yes	—

delete_item full type

{
  id: string
}

get

items.get Get an item by ID with column values Risk: read

await corsair.monday.api.items.get({});

Input

Name	Type	Required	Description
`item_id`	`string`	Yes	—

Output

Name	Type	Required	Description
`items`	`object[]`	Yes	—

items full type

{
  id: string,
  name: string,
  state?: string,
  created_at?: string | null,
  creator_id?: string | null,
  board?: {
    id: string
  },
  group?: {
    id: string,
    title?: string
  },
  column_values?: {
    id: string,
    title?: string,
    text?: string | null,
    value?: string | null,
    type?: string
  }[]
}[]

list

items.list List items in a board Risk: read

await corsair.monday.api.items.list({});

Input

Name	Type	Required	Description
`board_id`	`string`	Yes	—
`limit`	`number`	No	—
`cursor`	`string`	No	—

Output

Name	Type	Required	Description
`boards`	`object[]`	Yes	—

boards full type

{
  items_page: {
    cursor?: string | null,
    items: {
      id: string,
      name: string,
      state?: string,
      created_at?: string | null,
      creator_id?: string | null,
      board?: {
        id: string
      },
      group?: {
        id: string,
        title?: string
      },
      column_values?: {
        id: string,
        title?: string,
        text?: string | null,
        value?: string | null,
        type?: string
      }[]
    }[]
  }
}[]

move

items.move Move an item to a different group Risk: write

await corsair.monday.api.items.move({});

Input

Name	Type	Required	Description
`item_id`	`string`	Yes	—
`group_id`	`string`	Yes	—

Output

Name	Type	Required	Description
`move_item_to_group`	`object`	Yes	—

move_item_to_group full type

{
  id: string
}

update

items.update Update a column value on an item Risk: write

await corsair.monday.api.items.update({});

Input

Name	Type	Required	Description
`board_id`	`string`	Yes	—
`item_id`	`string`	Yes	—
`column_id`	`string`	Yes	—
`value`	`string`	Yes	—

Output

Name	Type	Required	Description
`change_column_value`	`object`	Yes	—

change_column_value full type

{
  id: string
}

Updates

create

updates.create Create an update (comment) on an item Risk: write

await corsair.monday.api.updates.create({});

Input

Name	Type	Required	Description
`item_id`	`string`	Yes	—
`body`	`string`	Yes	—

Output

Name	Type	Required	Description
`create_update`	`object`	Yes	—

create_update full type

{
  id: string,
  body?: string
}

delete

updates.delete Delete an update (comment) Risk: destructive

await corsair.monday.api.updates.delete({});

Input

Name	Type	Required	Description
`update_id`	`string`	Yes	—

Output

Name	Type	Required	Description
`delete_update`	`object`	Yes	—

delete_update full type

{
  id: string
}

list

updates.list List updates (comments) on an item Risk: read

await corsair.monday.api.updates.list({});

Input

Name	Type	Required	Description
`item_id`	`string`	Yes	—
`limit`	`number`	No	—
`page`	`number`	No	—

Output

Name	Type	Required	Description
`items`	`object[]`	Yes	—

items full type

{
  updates: {
    id: string,
    body?: string,
    text_body?: string | null,
    created_at?: string | null,
    creator?: {
      id: string,
      name?: string
    },
    replies?: {
      id: string,
      body?: string
    }[]
  }[]
}[]

Users

get

users.get Get a user by ID Risk: read

await corsair.monday.api.users.get({});

Input

Name	Type	Required	Description
`user_id`	`string`	Yes	—

Output

Name	Type	Required	Description
`users`	`object[]`	Yes	—

users full type

{
  id: string,
  name?: string,
  email?: string,
  photo_thumb?: string | null,
  title?: string | null,
  is_admin?: boolean,
  is_guest?: boolean
}[]

list

users.list List all users in the account Risk: read

await corsair.monday.api.users.list({});

Input

Name	Type	Required	Description
`limit`	`number`	No	—
`page`	`number`	No	—
`kind`	`all \| non_guests \| guests \| non_pending`	No	—

Output

Name	Type	Required	Description
`users`	`object[]`	Yes	—

users full type

{
  id: string,
  name?: string,
  email?: string,
  photo_thumb?: string | null,
  title?: string | null,
  is_admin?: boolean,
  is_guest?: boolean
}[]

Webhooks

create

webhooks.create Subscribe to a board event via webhook Risk: write

await corsair.monday.api.webhooks.create({});

Input

Name	Type	Required	Description
`board_id`	`string`	Yes	—
`url`	`string`	Yes	—
`event`	`change_column_value \| change_specific_column_value \| change_status_column_value \| create_item \| create_update \| delete_update \| item_archived \| item_deleted \| item_moved_to_board \| item_restored \| when_date_arrived`	Yes	—
`config`	`string`	No	—

Output

Name	Type	Required	Description
`create_webhook`	`object`	Yes	—

create_webhook full type

{
  id: string,
  board_id?: string,
  event?: string
}

delete

webhooks.delete Unsubscribe a webhook by ID Risk: destructive

await corsair.monday.api.webhooks.delete({});

Input

Name	Type	Required	Description
`webhook_id`	`string`	Yes	—

Output

Name	Type	Required	Description
`delete_webhook`	`object`	Yes	—

delete_webhook full type

{
  id: string,
  board_id?: string
}

list

webhooks.list List all webhooks for a board Risk: read

await corsair.monday.api.webhooks.list({});

Input

Name	Type	Required	Description
`board_id`	`string`	Yes	—

Output

Name	Type	Required	Description
`webhooks`	`object[]`	Yes	—

webhooks full type

{
  id: string,
  board_id?: string,
  event?: string
}[]

Workspaces

list

workspaces.list List all workspaces Risk: read

await corsair.monday.api.workspaces.list({});

Input

Name	Type	Required	Description
`limit`	`number`	No	—
`page`	`number`	No	—
`kind`	`open \| closed`	No	—
`state`	`active \| deleted \| all`	No	—

Output

Name	Type	Required	Description
`workspaces`	`object[]`	Yes	—

workspaces full type

{
  id: string,
  name: string,
  kind?: string,
  description?: string | null
}[]

​Boards

​archive

​create

​delete

​duplicate

​get

​list

​update

​Columns

​changeValue

​create

​list

​Groups

​create

​delete

​list

​update

​Items

​archive

​create

​delete

​get

​list

​move

​update

​Updates

​create

​delete

​list

​Users

​get

​list

​Webhooks

​create

​delete

​list

​Workspaces

​list

Boards

archive

create

delete

duplicate

get

list

update

Columns

changeValue

create

list

Groups

create

delete

list

update

Items

archive

create

delete

get

list

move

update

Updates

create

delete

list

Users

get

list

Webhooks

create

delete

list

Workspaces

list