Resource Directory

Learn how to read and update resource directories via the platform API

🚧

Only available in API versions 2026-01 and 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

You can use the get_directory_resources query to retrieve an account's resource directory data via the API.

  • 🚧 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(team_ids:["12345", "54321"]) {
    resources {
      id
      name
      email
    }
    cursor
    id
  }
}

Arguments

You can use the following arguments to reduce the number of results returned in your get_directory_resources query.

ArgumentDescription
cursor StringAn opaque token representing the position in a set of results to fetch resources from. Use this to paginate through large result sets.
limit IntThe number of resources to retrieve. Default is 25.
team_ids [String!]The unique identifiers of the team(s) to retrieve resources from.

Fields

You can use the following fields to specify what information your get_directory_resources query will return.

Field

Description

Supported Fields

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.

email String id ID!
name String!

Mutations

Update directory resources attributes

The update_directory_resources_attributes mutation allows you to update attributes of your resources in your account via the API. It returns the UpdateDirectoryResourceAttributesResponse type which allows you to specify which fields to return in the mutation response.

🚧 Only available for Enterprise plans

mutation {
  update_directory_resources_attributes(
    attribute: SKILLS
    value: ["React", "JavaScript"]
    resource_ids: [12345, 54321]
  ) {
    success
  }
}

Arguments

You can use the following arguments to define the directory resources to update.

Argument

Description

Enum Values

attribute DirectoryResourceAttribute!

The type of attribute(s) to update.

JOB_ROLE
LOCATION
RESOURCE_MANAGER
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.