Learn how to read and update resource directories via the platform API
Only available in API versions
2026-01and later
The monday.com Resource Directory provides a centralized overview of an account's resources. From there, you can define attributes (e.g., job roles, skills, locations, and resource managers), assign them to resources, and filter by those attributes to quickly find the right match for your projects.
🚧 Resource directories are only available on Enterprise plans.
Queries
Get directory resources
- 🚧 Only available for Enterprise plans
- Returns an array containing metadata about an account's resources
- Can only be queried directly at the root; can't be nested within another query
query {
get_directory_resources(limit: 25) {
resources {
id
name
email
}
cursor
id
}
}Example: Filter with query_params
query_paramsPass ItemsQuery as query_params. For each rule, set column_id to the Resource Directory attribute you want to filter on (for example JOB_ROLE, LOCATION, SKILLS, TEAMS, NAME, or EMAIL). Use ItemsQueryRuleOperator values such as contains_text or any_of together with compare_value, following the same patterns as items_page filters.
The query below requests resources whose job role contains "Engineer" and whose location contains "London". The top-level operator on query_params controls how multiple rules are combined (and or or).
query {
get_directory_resources(
limit: 25
query_params: {
operator: and
rules: [
{
column_id: "JOB_ROLE"
operator: contains_text
compare_value: "Engineer"
}
{
column_id: "LOCATION"
operator: contains_text
compare_value: "London"
}
]
}
) {
resources {
id
name
job_role
location
skills
}
cursor
id
}
}Arguments
| Argument | Type | Description |
|---|---|---|
| cursor | String | An opaque token representing the position in a set of results to fetch resources from. Use this to paginate through large result sets. |
| limit | Int | The number of resources to retrieve. Default is 25. |
| query_params | ItemsQuery | Filter directory resources by column-based attributes (e.g., job role, skills, location, and other resource attributes). |
Fields
| Field | Type | Description |
|---|---|---|
| cursor | String | An opaque cursor that represents the position in the list after the last returned resource. Use this cursor for pagination to fetch the next set of resources. If the cursor is null, there are no more resources to fetch. |
| id | ID! | The directory resource's unique identifier. |
| resources | [DirectoryResource!]! | The directory's resources. |
Mutations
- 🚧 Only available for Enterprise plans
Update directory resources attributes
Updates attributes of your resources in your account. Returns UpdateDirectoryResourceAttributesResponse.
mutation {
update_directory_resources_attributes(
attribute: SKILLS
values: ["React", "JavaScript"]
resource_ids: [12345, 54321]
) {
success
}
}Arguments
| Argument | Type | Description | Enum Values |
|---|---|---|---|
| attribute | DirectoryResourceAttribute! | The type of attribute(s) to update. | JOB_ROLELOCATION SKILLS |
| resource_ids | [ID!]! | The unique identifiers of the resources to update. Query get_directory_resources to retrieve the ID. | |
| values | [String!]! | The resource's updated attribute(s) values. The attribute must already exist; otherwise, the request will fail. |
