Use the Metadata Query API

Finally, build a . Here is an example of what the body of the API call looks like:

{
  "from": "enterprise_22201764.contact_role",
  "query": "departments = :departments",
  "query_params": {"departments": "legal"},
  "ancestor_folder_id": "0",
  "fields": ["id"]
}

This API call will return any file ID that meets the following criteria:

Has the Contact Role template applied
Has a value of departments is legal
Is located anywhere under the root folder, since “0” is the ancestor_folder_id

As you can see below, this results in a successful call showing information about the file we added the template to in step 2.

Last modified on January 19, 2026

Add Metadata Template to a File

Next Steps

⌘I

Getting started

Applications & integrations

Identity & access

Using the API

Troubleshooting

Content

Collaboration

Metadata & search

Events & webhooks

Users

Intelligent workflow

E-signatures

Security & compliance

Use the Metadata Query API