in code docs is OK for now, we'll have to docs on this restriction to the API, I imagine users won't expect this.