All examples below assume you have MONDAY_API_KEY set.
---
1. Get Current User
Query the authenticated user's info:
Write to /tmp/monday_request.json:
```json
{
"query": "query { me { id name email } }"
}
```
Then run:
```bash
bash -c 'curl -s -X POST "https://api.monday.com/v2" --header "Authorization: ${MONDAY_API_KEY}" --header "API-Version: 2024-10" --header "Content-Type: application/json" -d @/tmp/monday_request.json'
```
---
2. List All Boards
Get all boards in your account:
Write to /tmp/monday_request.json:
```json
{
"query": "query { boards (limit: 10) { id name state items_count } }"
}
```
Then run:
```bash
bash -c 'curl -s -X POST "https://api.monday.com/v2" --header "Authorization: ${MONDAY_API_KEY}" --header "API-Version: 2024-10" --header "Content-Type: application/json" -d @/tmp/monday_request.json'
```
---
3. Get Board Details
Get a specific board with its groups and columns:
Write to /tmp/monday_request.json:
```json
{
"query": "query { boards (ids: ) { id name groups { id title } columns { id title type } } }"
}
```
Replace with an actual board ID from the "List All Boards" response (example 2).
Then run:
```bash
bash -c 'curl -s -X POST "https://api.monday.com/v2" --header "Authorization: ${MONDAY_API_KEY}" --header "API-Version: 2024-10" --header "Content-Type: application/json" -d @/tmp/monday_request.json'
```
---
4. Get Items from a Board
Get items (rows) from a specific board:
Write to /tmp/monday_request.json:
```json
{
"query": "query { boards (ids: ) { items_page (limit: 10) { items { id name column_values { id text value } } } } }"
}
```
Replace with an actual board ID from the "List All Boards" response (example 2).
Then run:
```bash
bash -c 'curl -s -X POST "https://api.monday.com/v2" --header "Authorization: ${MONDAY_API_KEY}" --header "API-Version: 2024-10" --header "Content-Type: application/json" -d @/tmp/monday_request.json'
```
---
5. Create a New Item
Create a new item in a board:
Write to /tmp/monday_request.json:
```json
{
"query": "mutation { create_item (board_id: , group_id: \"\", item_name: \"\") { id name } }"
}
```
Replace the following values:
: An actual board ID from the "List All Boards" response (example 2): A group ID from the "Get Board Details" response (example 3, groups array): Your desired name for the new item
Then run:
```bash
bash -c 'curl -s -X POST "https://api.monday.com/v2" --header "Authorization: ${MONDAY_API_KEY}" --header "API-Version: 2024-10" --header "Content-Type: application/json" -d @/tmp/monday_request.json'
```
---
6. Create Item with Column Values
Create an item with specific column values:
Write to /tmp/monday_request.json:
```json
{
"query": "mutation ($boardId: ID!, $groupId: String!, $itemName: String!, $columnValues: JSON!) { create_item (board_id: $boardId, group_id: $groupId, item_name: $itemName, column_values: $columnValues) { id name } }",
"variables": {
"boardId": "",
"groupId": "",
"itemName": "",
"columnValues": "{\"status\": {\"label\": \"Working on it\"}, \"date\": {\"date\": \"2025-01-15\"}}"
}
}
```
Replace the following values:
: An actual board ID from the "List All Boards" response (example 2): A group ID from the "Get Board Details" response (example 3, groups array): Your desired name for the new item
Then run:
```bash
bash -c 'curl -s -X POST "https://api.monday.com/v2" --header "Authorization: ${MONDAY_API_KEY}" --header "API-Version: 2024-10" --header "Content-Type: application/json" -d @/tmp/monday_request.json'
```
---
7. Update an Item
Update an existing item's column values:
Write to /tmp/monday_request.json:
```json
{
"query": "mutation ($boardId: ID!, $itemId: ID!, $columnValues: JSON!) { change_multiple_column_values (board_id: $boardId, item_id: $itemId, column_values: $columnValues) { id name } }",
"variables": {
"boardId": "",
"itemId": "",
"columnValues": "{\"status\": {\"label\": \"Done\"}}"
}
}
```
Replace the following values:
: An actual board ID from the "List All Boards" response (example 2): An item ID from the "Get Items from a Board" response (example 4)
Then run:
```bash
bash -c 'curl -s -X POST "https://api.monday.com/v2" --header "Authorization: ${MONDAY_API_KEY}" --header "API-Version: 2024-10" --header "Content-Type: application/json" -d @/tmp/monday_request.json'
```
---
8. Delete an Item
Delete an item from a board:
Write to /tmp/monday_request.json:
```json
{
"query": "mutation { delete_item (item_id: ) { id } }"
}
```
Replace with an actual item ID from the "Get Items from a Board" response (example 4).
Then run:
```bash
bash -c 'curl -s -X POST "https://api.monday.com/v2" --header "Authorization: ${MONDAY_API_KEY}" --header "API-Version: 2024-10" --header "Content-Type: application/json" -d @/tmp/monday_request.json'
```
---
9. Create a New Board
Create a new board:
Write to /tmp/monday_request.json:
```json
{
"query": "mutation { create_board (board_name: \"My New Board\", board_kind: public) { id name } }"
}
```
Then run:
```bash
bash -c 'curl -s -X POST "https://api.monday.com/v2" --header "Authorization: ${MONDAY_API_KEY}" --header "API-Version: 2024-10" --header "Content-Type: application/json" -d @/tmp/monday_request.json'
```
---
10. Search Items
Search for items across boards:
Write to /tmp/monday_request.json:
```json
{
"query": "query { items_page_by_column_values (limit: 10, board_id: , columns: [{column_id: \"name\", column_values: [\"Task\"]}]) { items { id name } } }"
}
```
Replace with an actual board ID from the "List All Boards" response (example 2).
Then run:
```bash
bash -c 'curl -s -X POST "https://api.monday.com/v2" --header "Authorization: ${MONDAY_API_KEY}" --header "API-Version: 2024-10" --header "Content-Type: application/json" -d @/tmp/monday_request.json'
```
---