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

GraphQLRepositoriescustomEntityType

entities.customEntityType

Read custom entity type records with the customEntityType repository, and change them with the custom entity type mutations. Same records as the REST {custom_entity_type_api_name} entity.

Queries

Fields of entities { customEntityType { … } }.

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

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.

CustomEntityTypeEntity object 15 fields: hasDraft, isDeleteProtected, formEditApi, …

Configurable category of records of a custom entity that defines their form layout and settings; entityApiName names the custom entity.

FieldTypeDescription
hasDraftBooleanTrue when the record has unpublished draft changes, including pending translation changes, that can be published.
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.
formEditApiFormTyped, read-only view of a form layout of this type: formEditApi mirrors the edit form (formEdit), formLostApi the form shown when archiving as lost (formLost).
canChangeReadonlyBooleanFalse for types whose read-only setting is fixed, such as the recurrent appointment type; true otherwise.
idID!Unique identifier of entity.
isDeletedBooleanSpecifies if the entity is considered deleted.
modifiedDateTimeLast modification time.
createdDateTimeCreation time.
formEditJSONString!JSON definition of the form layout used by the UI when creating or editing records of this custom entity type.
isReadonlyBoolean!True when the custom entity type is system-managed and cannot be edited or deleted by users.
nameString!Name of the entity and its default text representation.
settingsEntityTypeSettings!Per-type configuration for records of this entity type, e.g. allowed task and appointment types that may be linked to records of this type.
isPublishedBooleanTrue when the entity configuration is published; false while it exists only as an unpublished draft.
entityApiNameStringAPI name of the custom entity type (e.g. "Vehicle", "Project_Phase"). Used as the entity name when calling REST endpoints or selecting a concrete custom entity in GraphQL.
instancePermissions[EntityPermsEnum!]! (1 args)Permissions the current user has on this record, out of the requested ones.
CustomEntityTypeEntityConnection object pageInfo: PageInfo!, edges: [CustomEntityTypeEntityEdge]!, totalCount: Int

Paginated list of CustomEntityType records.

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

A Relay edge containing a CustomEntityTypeEntity and its cursor.

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

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

Input fieldTypeDescription
OR[CustomEntityTypeFilterInput!]Matches records that meet at least one of the listed filters.
AND[CustomEntityTypeFilterInput!]Matches records that meet all of the listed filters.
NOTCustomEntityTypeFilterInputMatches 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.
isReadonlyBooleanTrue when the custom entity type is system-managed and cannot be edited or deleted by users.
nameEntityFilterStringFieldName of the entity and its default text representation.
isPublishedBooleanTrue when the entity configuration is published; false while it exists only as an unpublished draft.
CustomEntityTypeOrderByInput input Asc or Desc per field

Sorting of CustomEntityType 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.
isReadonlyOrderByEnumTrue when the custom entity type is system-managed and cannot be edited or deleted by users.
nameOrderByEnumName of the entity and its default text representation.
isPublishedOrderByEnumTrue when the entity configuration is published; false while it exists only as an unpublished draft.