> ## Documentation Index
> Fetch the complete documentation index at: https://developers.myhero.so/llms.txt
> Use this file to discover all available pages before exploring further.

# List relation candidates

> List the records (rows) a relation (oneMany) column may link to. With a relation filter this is the narrowed set, which is what the picker offers; without…

`list_relation_candidates`

List the records (rows) a relation (oneMany) column may link to. With a relation filter this is the narrowed set, which is what the picker offers; without one it is every row in the linked table. Pass rowId when the filter reads a value off the row being edited — without it there is no row to read and the call reports FILTER\_SOURCE\_EMPTY rather than falling back to everything.

## Parameters

**columnId** `string` *required*

The oneMany column.

**rowId** `string`

The row being edited. Required by a dynamic filter.

**maxRows** `integer` (default: 200)

Minimum: 1.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.