No, you linked to “43.10. Interacting with relations and backrelations in code”, I linked to “43.1. Creating relations in a schema” . But is’s the same document
Yes, but I don't see how to defined the classification of a relation using a relationship parameter. A relation between a source and target object is always associated with related relationship string. I think, relatedItem (or so is used) for related items..but in many cases you what a different classification for a custom relationship.
The name of the relationship is the name of the field (not like in AT where these were separate values).
If you have a relationfield (choice or list) with the name friend the call api.relation.create(source=x, target=y, relationship="friend") creates such a relation and sets that relationValue as a value in that field on x. If there is no field, the relation is created without changing the value of the field.
ok, this information is missing from the docs (and not directly obvious).
From the developer's prospective, it would be handy if you could specify the relationship name explicitly.