[Official Endor Labs SDK docs (troubleshooting.md)]: With a non-empty mask (mask= / ListParameters.mask), list() and list_iter() return wire JSON dicts (or iterate dicts), not sparse Pydantic instances. Use dict access on those rows, or omit mask when you need full models. Even with no mask, at some scopes (for example tenant root) the API omits fields the OpenAPI schema marks required and the SDK is lenient: Finding.context may be omitted, Project.spec.platform_source may be omitted, and BaseMeta.name may be omitted. Treat those attributes as possibly None on every model instance.

Context: Official docs (endorlabs-sdk troubleshooting.md): documents two list() gotchas that trip agents. Passing mask= to list() changes the return type from Pydantic models to wire JSON dicts, so attribute access breaks. Separately, the API may omit spec-required fields at some scopes, and the SDK applies leniency instead of erroring, so callers must still handle None.