Dm Limits And Best Practices

If you're hitting 429s or dealing with pagination headaches in CDF Data Modeling, this is your reference. It covers the concurrency limits for apply, delete, and query operations, explains when to use instances.search versus filter (with concrete AND/OR operator examples), and shows how to batch write operations and handle the 1000-value limit on in filters. The real utility is the QueuedTaskRunner semaphore implementation, a reusable class that wraps your CDF API calls to prevent rate limit errors and deadlocks by controlling concurrent requests. The skill includes full source code you can drop into your project, plus decision tables for search versus filter scenarios.

skills.sh installs: 1.9K
GitHub stars: 6
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add cognitedata/builder-skills --skill dm-limits-and-best-practices --agent claude-code

Installs into .claude/skills of the current project.

Files

CDF Data Modeling: Limits, Concurrency & Best Practices

This is a reference skill. When writing or reviewing code that calls CDF Data Modeling APIs, apply the patterns below.

This skill owns runtime reliability concerns: limits, concurrency, retries, throughput, and batching behavior. For traversal payload correctness and graph-specific failure signatures, see dm-graph-traversal.

DMS Limits Reference

For the latest concurrency limits, resource limits, and property value limits, see the official documentation: https://docs.cognite.com/cdf/dm/dm_reference/dm_limits_and_restrictions

Key things to be aware of:

Instance apply, delete, and query operations each have their own concurrent request limits
Exceeding these limits returns 429 Too Many Requests
Transformations consume a large portion of the concurrency budget, leaving less for other clients
instances.list has a max page size (use pagination for complete results)
instances.query table expressions each have their own item limit
instances.upsert accepts up to 1000 items per call
in filters accept at most 1000 values per expression; larger sets must be split into batches

SKILL.md on GitHub

Details

Repository: github.com/cognitedata/builder-skills
Categories: Backend & APIs, Debugging
First seen: Jun 3, 2026