The monday.com search API allows you to find items, boards, documents, users, workspaces, updates, and timeline items across your account. It uses a combination of keyword matching and semantic understanding to return the most relevant results.

Unlike a traditional search query that returns a mixed list of results, the search API uses a namespace structure — search returns a SearchNamespace object with separate fields for each entity type. This lets you search multiple entity types in a single request while specifying different filters for each.

Queries

Search across entities

Required scopes vary by entity type:

• Returns SearchNamespace! — an object with one field per entity type
• Can be queried directly at the root
• Request only the entity type fields you need — omitting a field avoids unnecessary processing
• The limit argument on each field applies to that entity type only

Each entity type is accessed as a field on the returned SearchNamespace. Include only the fields for the entity types you want to search in a single request:

query {
  search {
    items(query: "Q1 planning", limit: 10, board_ids: ["1234567890"]) {
      results {
        id
        indexed_data {
          name
          board_id
          url
        }
        live_data {
          id
          name
          state
        }
      }
    }
    boards(query: "Q1 planning", limit: 10) {
      results {
        id
        indexed_data {
          name
          url
        }
      }
    }
    docs(query: "Q1 planning", limit: 5) {
      results {
        id
        indexed_data {
          name
        }
      }
    }
    users(query: "Ada", limit: 5) {
      results {
        id
        indexed_data {
          name
          email
        }
      }
    }
    workspaces(query: "Q1 planning", limit: 5) {
      results {
        id
        indexed_data {
          name
        }
      }
    }
    updates(query: "Q1 planning", limit: 5, board_ids: ["1234567890"]) {
      results {
        id
        indexed_data {
          body
          creator_id
          item_id
          board_id
          created_at
          updated_at
        }
        live_data {
          id
          body
        }
      }
    }
    timeline_items(query: "kickoff call", limit: 5, type: email) {
      results {
        id
        indexed_data {
          title
          summary
          type
          product_kind
          item_id
          board_id
        }
        live_data {
          id
        }
      }
    }
  }
}

Arguments

The search query itself takes no arguments. Arguments are passed to each entity field on the SearchNamespace.

search.items arguments:

search.boards arguments:

search.docs arguments:

search.users arguments:

search.workspaces arguments:

search.updates arguments:

search.timeline_items arguments:

Fields

Each entity field on SearchNamespace returns a result container object with a single results field:

Each result in the results array includes:

Authorization

Authorization is applied automatically based on the authenticated user context. Results are filtered to the items, boards, documents, users, workspaces, updates, and timeline items the caller is allowed to access — inaccessible results are excluded from the response.

Limits

Results are returned ordered by relevance within each entity type. No cursor-based pagination is available — all results are returned up to the specified limit.