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

GraphQLRepositoriesaccountRole

entities.accountRole

Read account role records with the accountRole repository, and change them with the account role mutations. Same records as the REST AccountRoles entity.

Queries

Fields of entities { accountRole { … } }.

KindFieldReturns
QUERYgetById(entityId: ID!)
Returns the record with the given id, or null when there is none. Deleted records are returned as well.
AccountRoleEntity
QUERYgetByIds(entityIds: [ID!]!)
Returns the records with the given ids; ids without a record are left out. Deleted records are returned as well.
[AccountRoleEntity!]!
QUERYgetAll(limit: Int, offset: Int, filter: AccountRoleFilterInput, orderBy: [AccountRoleOrderByInput!], includeDeleted: Boolean)
Returns the records that match the filter, paged with limit and offset.
[AccountRoleEntity!]!
QUERYgetByCriteria(filter: AccountRoleFilterInput, orderBy: [AccountRoleOrderByInput!], includeDeleted: Boolean, before: String, after: String, first: Int, last: Int)
Returns the records that match the filter as a cursor-paginated connection.
AccountRoleEntityConnection
QUERYgetChangedFieldsSinceRevision(id: UUID!, revision: Int!)
Returns the ids of the fields of a record that changed after the given revision. Returns an empty list for entities without change tracking.
[UUID!]!

Mutations

KindMutationDoesReturns
MUTATIONcreateAccountRole(input: CreateAccountRoleInput!, validationLevel: [ValidationLevel!])Create one recordCreateAccountRolePayload
MUTATIONupdateAccountRole(input: UpdateAccountRoleInput!, validationLevel: [ValidationLevel!], sessionIdToUpdate: String)Update fieldsUpdateAccountRolePayload
MUTATIONbulkUpdateAccountRole(input: [CreateOrUpdateAccountRoleInput!]!, deleteInput: [DeleteAccountRoleInput!], validationLevel: [ValidationLevel!], rollbackMethod: RollbackMethod, match: MatchingInput)Create or update many; per-item resultsBulkUpdateAccountRolePayload
MUTATIONdeleteAccountRole(input: DeleteAccountRoleInput!)Soft-deleteDeleteAccountRolePayload

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.

AccountRoleEntity object 9 fields: isDeleteProtected, id, isDeleted, …

Role a contact can hold at an account, configurable per space and assigned on the link between the contact and the account.

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.
idID!Unique identifier of entity.
isDeletedBooleanSpecifies if the entity is considered deleted.
modifiedDateTimeLast modification time.
createdDateTimeCreation time.
colorInt!Display color of the role label, encoded as an integer packing the RGB components: (red << 16) | (green << 8) | blue.
labelString!Name of the entity and its default text representation.
revisionIntRevision when entity was lastly changed.
instancePermissions[EntityPermsEnum!]! (1 args)Permissions the current user has on this record, out of the requested ones.
AccountRoleEntityConnection object pageInfo: PageInfo!, edges: [AccountRoleEntityEdge]!, totalCount: Int

Paginated list of AccountRole records.

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

A Relay edge containing a AccountRoleEntity and its cursor.

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

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

Input fieldTypeDescription
OR[AccountRoleFilterInput!]Matches records that meet at least one of the listed filters.
AND[AccountRoleFilterInput!]Matches records that meet all of the listed filters.
NOTAccountRoleFilterInputMatches 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.
colorEntityFilterNumberFieldDisplay color of the role label, encoded as an integer packing the RGB components: (red << 16) | (green << 8) | blue.
labelEntityFilterStringFieldName of the entity and its default text representation.
revisionEntityFilterNumberFieldRevision when entity was lastly changed.
AccountRoleOrderByInput input Asc or Desc per field

Sorting of AccountRole 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.
colorOrderByEnumDisplay color of the role label, encoded as an integer packing the RGB components: (red << 16) | (green << 8) | blue.
labelOrderByEnumName of the entity and its default text representation.
revisionOrderByEnumRevision when entity was lastly changed.
CreateAccountRoleInput input 6 fields: clientMutationId, modified, created, …

Field values of a new AccountRole record.

Input fieldTypeDescription
clientMutationIdStringOptional client-supplied identifier passed on a mutation input and echoed back unchanged on its payload, so a client can correlate the response with its request (Relay convention).
modifiedDateTimeLast modification time.
createdDateTimeCreation time.
colorInt!Display color of the role label, encoded as an integer packing the RGB components: (red << 16) | (green << 8) | blue.
labelString!Name of the entity and its default text representation.
revisionIntRevision when entity was lastly changed.
CreateOrUpdateAccountRoleInput input 7 fields: clientMutationId, id, modified, …

Field values of an AccountRole record to create, or to update when its id is set.

Input fieldTypeDescription
clientMutationIdStringOptional client-supplied identifier passed on a mutation input and echoed back unchanged on its payload, so a client can correlate the response with its request (Relay convention).
idIDUnique identifier of entity.
modifiedDateTimeLast modification time.
createdDateTimeCreation time.
colorIntDisplay color of the role label, encoded as an integer packing the RGB components: (red << 16) | (green << 8) | blue.
labelStringName of the entity and its default text representation.
revisionIntRevision when entity was lastly changed.
DeleteAccountRoleInput input clientMutationId: String, id: ID!

Id of the AccountRole record to delete.

Input fieldTypeDescription
clientMutationIdStringOptional client-supplied identifier passed on a mutation input and echoed back unchanged on its payload, so a client can correlate the response with its request (Relay convention).
idID!Unique identifier of entity.
UpdateAccountRoleInput input 7 fields: clientMutationId, id, modified, …

Id of an AccountRole record and the field values to change.

Input fieldTypeDescription
clientMutationIdStringOptional client-supplied identifier passed on a mutation input and echoed back unchanged on its payload, so a client can correlate the response with its request (Relay convention).
idID!Unique identifier of entity.
modifiedDateTimeLast modification time.
createdDateTimeCreation time.
colorIntDisplay color of the role label, encoded as an integer packing the RGB components: (red << 16) | (green << 8) | blue.
labelStringName of the entity and its default text representation.
revisionIntRevision when entity was lastly changed.
BulkUpdateAccountRolePayload object result: BulkUpdateResults!

Result of the bulkUpdateAccountRole mutation.

FieldTypeDescription
resultBulkUpdateResults!Ids of the created, updated and deleted records, and the items that failed.
CreateAccountRolePayload object accountRole: AccountRoleEntity, clientMutationId: String

Result of the createAccountRole mutation.

FieldTypeDescription
accountRoleAccountRoleEntityThe created record.
clientMutationIdStringOptional client-supplied identifier passed on a mutation input and echoed back unchanged on its payload, so a client can correlate the response with its request (Relay convention).
DeleteAccountRolePayload object accountRole: AccountRoleEntity, clientMutationId: String

Result of the deleteAccountRole mutation.

FieldTypeDescription
accountRoleAccountRoleEntityThe deleted record.
clientMutationIdStringOptional client-supplied identifier passed on a mutation input and echoed back unchanged on its payload, so a client can correlate the response with its request (Relay convention).
UpdateAccountRolePayload object accountRole: AccountRoleEntity, clientMutationId: String

Result of the updateAccountRole mutation.

FieldTypeDescription
accountRoleAccountRoleEntityThe updated record.
clientMutationIdStringOptional client-supplied identifier passed on a mutation input and echoed back unchanged on its payload, so a client can correlate the response with its request (Relay convention).