Developers
Set your API contextPick a region and space ID once. Every sample fills in your base URL.
Where do I find these?

In Coevera: open your space's API application and choose Show Access. It shows the space ID and the base URL, whose host starts with your region.

From the API: if you know the space ID, the discovery endpoint GET /api/discovery/spaces/{space_id} returns its region and base URLs, without credentials.

Only the region and space ID are kept, in this browser. Never paste a key or password here.

More in the quickstart

GraphQLRepositoriescustomEntityRelation

entities.customEntityRelation

Read custom entity relation records with the customEntityRelation repository.

Queries

Fields of entities { customEntityRelation { … } }.

KindFieldReturns
QUERYgetById(entityId: ID!)
Returns the record with the given id, or null when there is none. Deleted records are returned as well.
CustomEntityRelationEntity
QUERYgetByIds(entityIds: [ID!]!)
Returns the records with the given ids; ids without a record are left out. Deleted records are returned as well.
[CustomEntityRelationEntity!]!
QUERYgetAll(limit: Int, offset: Int, filter: CustomEntityRelationFilterInput, orderBy: [CustomEntityRelationOrderByInput!], includeDeleted: Boolean)
Returns the records that match the filter, paged with limit and offset.
[CustomEntityRelationEntity!]!
QUERYgetByCriteria(filter: CustomEntityRelationFilterInput, orderBy: [CustomEntityRelationOrderByInput!], includeDeleted: Boolean, before: String, after: String, first: Int, last: Int)
Returns the records that match the filter as a cursor-paginated connection.
CustomEntityRelationEntityConnection
QUERYgetPublished(limit: Int, offset: Int, filter: CustomEntityRelationFilterInput, orderBy: [CustomEntityRelationOrderByInput!], includeDeleted: Boolean)
Returns the published records that match the filter, paged with limit and offset.
[CustomEntityRelationEntity!]!
QUERYgetDrafts(filter: CustomEntityRelationFilterInput, orderBy: [CustomEntityRelationOrderByInput!])
Returns the records that match the filter, with pending unpublished changes applied where a draft exists.
[CustomEntityRelationEntity!]!
QUERYgetDraftById(entityId: ID!)
Returns the record with the given id, with its pending unpublished changes applied when a draft exists.
CustomEntityRelationEntity!

Types

The types this repository uses, each with its fields and their descriptions. Types several repositories share, such as PageInfo and the filter fields, are in the types index.

CustomEntityRelationEntity object 22 fields: isDeleteProtected, hasDraft, id, …

Custom relation that links records of two entities through a pair of relation fields, one on each side.

FieldTypeDescription
isDeleteProtectedBoolean!True when the record is protected against deletion because it must always exist in the space. Deleting a record that is not protected can still fail on other checks. Read-only.
hasDraftBooleanTrue when the record has unpublished draft changes, including pending translation changes, that can be published.
idID!Unique identifier of entity.
isDeletedBooleanSpecifies if the entity is considered deleted.
modifiedDateTimeLast modification time.
createdDateTimeCreation time.
field1FieldEntityLookup field on the first side of the custom relation: the lookup field the relation was created from.
field2FieldEntityLookup field on the second side of the custom relation, created automatically on the linked entity.
entityFilter1JSONStringCondition limiting which records of the field_1 entity can be selected in field_2, as a JSON object conforming to the FieldFilter type; empty for no restriction.
entityFilter2JSONStringCondition limiting which records of the field_2 entity can be selected in field_1, as a JSON object conforming to the FieldFilter type; empty for no restriction.
field1IdID!Id of the lookup field on the first side of the custom relation.
field2IdID!Id of the lookup field on the second side of the custom relation.
hasIsPrimaryBooleanWhen true, one of the records linked through the relation can be marked as primary. Cannot be switched back to false once enabled.
showRelated1BooleanWhen true, field2 offers only records related to the record being edited. Not supported yet; must be false.
showRelated2BooleanWhen true, field1 offers only records related to the record being edited (e.g. the contacts of its account).
showTab1Boolean!When true, the records linked through field1 are shown in a tab named tabName1.
showTab2Boolean!When true, the records linked through field2 are shown in a tab named tabName2.
tabName1String!Name of the tab that shows the records linked through field1.
tabName2String!Name of the tab that shows the records linked through field2.
isPublishedBooleanTrue when the entity configuration is published; false while it exists only as an unpublished draft.
revisionIntRevision when entity was lastly changed.
instancePermissions[EntityPermsEnum!]! (1 args)Permissions the current user has on this record, out of the requested ones.
CustomEntityRelationEntityConnection object pageInfo: PageInfo!, edges: [CustomEntityRelationEntityEdge]!, totalCount: Int

Paginated list of CustomEntityRelation records.

FieldTypeDescription
pageInfoPageInfo!Pagination data for this connection.
edges[CustomEntityRelationEntityEdge]!Contains the nodes in this connection.
totalCountIntTotal number of items in the connection.
CustomEntityRelationEntityEdge object node: CustomEntityRelationEntity, cursor: String!

A Relay edge containing a CustomEntityRelationEntity and its cursor.

FieldTypeDescription
nodeCustomEntityRelationEntityThe item at the end of the edge
cursorString!A cursor for use in pagination
CustomEntityRelationFilterInput input AND, OR, NOT, globalSearchQuery, one condition per field

Filter conditions for CustomEntityRelation records. Conditions on different fields are combined with AND; use OR, AND and NOT for other combinations.

Input fieldTypeDescription
OR[CustomEntityRelationFilterInput!]Matches records that meet at least one of the listed filters.
AND[CustomEntityRelationFilterInput!]Matches records that meet all of the listed filters.
NOTCustomEntityRelationFilterInputMatches records that do not meet this filter.
globalSearchQueryStringSearch term matched against the fields that the global search covers for this entity.
idEntityFilterStringFieldUnique identifier of entity.
isDeletedBooleanSpecifies if the entity is considered deleted.
modifiedEntityFilterDateTimeFieldLast modification time.
createdEntityFilterDateTimeFieldCreation time.
field1IdEntityFilterStringFieldId of the lookup field on the first side of the custom relation.
field2IdEntityFilterStringFieldId of the lookup field on the second side of the custom relation.
hasIsPrimaryBooleanWhen true, one of the records linked through the relation can be marked as primary. Cannot be switched back to false once enabled.
showRelated1BooleanWhen true, field2 offers only records related to the record being edited. Not supported yet; must be false.
showRelated2BooleanWhen true, field1 offers only records related to the record being edited (e.g. the contacts of its account).
showTab1BooleanWhen true, the records linked through field1 are shown in a tab named tabName1.
showTab2BooleanWhen true, the records linked through field2 are shown in a tab named tabName2.
tabName1EntityFilterStringFieldName of the tab that shows the records linked through field1.
tabName2EntityFilterStringFieldName of the tab that shows the records linked through field2.
isPublishedBooleanTrue when the entity configuration is published; false while it exists only as an unpublished draft.
revisionEntityFilterNumberFieldRevision when entity was lastly changed.
field1FieldFilterInputLookup field on the first side of the custom relation: the lookup field the relation was created from. Matches records where a related record meets these conditions.
field2FieldFilterInputLookup field on the second side of the custom relation, created automatically on the linked entity. Matches records where a related record meets these conditions.
CustomEntityRelationOrderByInput input Asc or Desc per field

Sorting of CustomEntityRelation records. Set exactly one field in each item; list several items to sort by more fields, in order of priority.

Input fieldTypeDescription
idOrderByEnumUnique identifier of entity.
isDeletedOrderByEnumSpecifies if the entity is considered deleted.
modifiedOrderByEnumLast modification time.
createdOrderByEnumCreation time.
field1[FieldOrderByNestedInput!]Lookup field on the first side of the custom relation: the lookup field the relation was created from. Sorts by fields of the related record, listed in order of priority.
field2[FieldOrderByNestedInput!]Lookup field on the second side of the custom relation, created automatically on the linked entity. Sorts by fields of the related record, listed in order of priority.
field1IdOrderByEnumId of the lookup field on the first side of the custom relation.
field2IdOrderByEnumId of the lookup field on the second side of the custom relation.
hasIsPrimaryOrderByEnumWhen true, one of the records linked through the relation can be marked as primary. Cannot be switched back to false once enabled.
showRelated1OrderByEnumWhen true, field2 offers only records related to the record being edited. Not supported yet; must be false.
showRelated2OrderByEnumWhen true, field1 offers only records related to the record being edited (e.g. the contacts of its account).
showTab1OrderByEnumWhen true, the records linked through field1 are shown in a tab named tabName1.
showTab2OrderByEnumWhen true, the records linked through field2 are shown in a tab named tabName2.
tabName1OrderByEnumName of the tab that shows the records linked through field1.
tabName2OrderByEnumName of the tab that shows the records linked through field2.
isPublishedOrderByEnumTrue when the entity configuration is published; false while it exists only as an unpublished draft.
revisionOrderByEnumRevision when entity was lastly changed.