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

GraphQLRepositoriescontactType

entities.contactType

Read contact type records with the contactType repository, and change them with the contact type mutations. Same records as the REST ContactTypes entity.

Queries

Fields of entities { contactType { … } }.

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

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.

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

Configurable category of contacts that defines the form layout and settings used for contacts of that type.

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 edit form layout used by the UI when creating or editing contacts of this type. Contains tabs, sections, and field placement. This payload conforms to the Form JSON Schema: GET /api/v100/rest/schemas/Form.json on your region's API host
isReadonlyBoolean!True when the contact 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. This payload conforms to the EntityTypeSettings JSON Schema: GET /api/v100/rest/schemas/EntityTypeSettings.json on your region's API host
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.
ContactTypeEntityConnection object pageInfo: PageInfo!, edges: [ContactTypeEntityEdge]!, totalCount: Int

Paginated list of ContactType records.

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

A Relay edge containing a ContactTypeEntity and its cursor.

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

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

Input fieldTypeDescription
OR[ContactTypeFilterInput!]Matches records that meet at least one of the listed filters.
AND[ContactTypeFilterInput!]Matches records that meet all of the listed filters.
NOTContactTypeFilterInputMatches 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 contact 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.
revisionEntityFilterNumberFieldRevision when entity was lastly changed.
ContactTypeOrderByInput input Asc or Desc per field

Sorting of ContactType 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 contact 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.
revisionOrderByEnumRevision when entity was lastly changed.