GraphQL Repositoriestask

`entities.task`

Read task records with the task repository, and change them with the task mutations. Same records as the REST Tasks entity.

10 queries
12 mutations
REST: Tasks

Example: first three task recordsGraphQLcURL

query FirstTasks {
  entities {
    task {
      getByCriteria(first: 3, orderBy: [{ modified: Desc }]) {
        totalCount
        edges { node { id formattedName subject modified } }
      }
    }
  }
}

curl 'https://{region}.api.coevera.com/api/v100/app/space/{space_id}/graphql/public' \
  --user "$COEVERA_API_KEY:$COEVERA_API_SECRET" \
  --header 'Content-Type: application/json' \
  --data '{"query":"query FirstTasks { entities { task { getByCriteria(first: 3, orderBy: [{ modified: Desc }]) { totalCount edges { node { id formattedName subject modified } } } } } }"}'

Queries

Fields of entities { task { … } }.

Each operation opens an example built from the schema and checked against it on every build. Replace the placeholders, such as <task id>, with values from your space.

Kind	Field	Returns
QUERY	`getById`(entityId: ID!) Returns the record with the given id, or null when there is none. Deleted records are returned as well.	TaskEntity
Example Example: getByIdGraphQLcURL `query TaskGetById { entities { task { getById(entityId: "<task id>") { id formattedName subject modified } } } }` `curl 'https://{region}.api.coevera.com/api/v100/app/space/{space_id}/graphql/public' \ --user "$COEVERA_API_KEY:$COEVERA_API_SECRET" \ --header 'Content-Type: application/json' \ --data '{"query":"query TaskGetById { entities { task { getById(entityId: \"<task id>\") { id formattedName subject modified } } } }"}'`
QUERY	`getByIds`(entityIds: [ID!]!) Returns the records with the given ids; ids without a record are left out. Deleted records are returned as well.	[TaskEntity!]!
Example Example: getByIdsGraphQLcURL `query TaskGetByIds { entities { task { getByIds(entityIds: ["<task id>"]) { id formattedName subject modified } } } }` `curl 'https://{region}.api.coevera.com/api/v100/app/space/{space_id}/graphql/public' \ --user "$COEVERA_API_KEY:$COEVERA_API_SECRET" \ --header 'Content-Type: application/json' \ --data '{"query":"query TaskGetByIds { entities { task { getByIds(entityIds: [\"<task id>\"]) { id formattedName subject modified } } } }"}'`
QUERY	`getAll`(limit: Int, offset: Int, filter: TaskFilterInput, orderBy: [TaskOrderByInput!], includeDeleted: Boolean) Returns the records that match the filter, paged with limit and offset.	[TaskEntity!]!
Example Example: getAllGraphQLcURL `query TaskGetAll { entities { task { getAll(limit: 10) { id formattedName subject modified } } } }` `curl 'https://{region}.api.coevera.com/api/v100/app/space/{space_id}/graphql/public' \ --user "$COEVERA_API_KEY:$COEVERA_API_SECRET" \ --header 'Content-Type: application/json' \ --data '{"query":"query TaskGetAll { entities { task { getAll(limit: 10) { id formattedName subject modified } } } }"}'`
QUERY	`getByCriteria`(filter: TaskFilterInput, orderBy: [TaskOrderByInput!], includeDeleted: Boolean, before: String, after: String, first: Int, last: Int) Returns the records that match the filter as a cursor-paginated connection.	TaskEntityConnection
Example Example: getByCriteriaGraphQLcURL `query TaskGetByCriteria { entities { task { getByCriteria(first: 10) { totalCount edges { node { id formattedName subject modified } } pageInfo { hasNextPage endCursor } } } } }` `curl 'https://{region}.api.coevera.com/api/v100/app/space/{space_id}/graphql/public' \ --user "$COEVERA_API_KEY:$COEVERA_API_SECRET" \ --header 'Content-Type: application/json' \ --data '{"query":"query TaskGetByCriteria { entities { task { getByCriteria(first: 10) { totalCount edges { node { id formattedName subject modified } } pageInfo { hasNextPage endCursor } } } } }"}'`
QUERY	`getChangedFieldsSinceRevision`(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!]!
Example Example: getChangedFieldsSinceRevisionGraphQLcURL `query TaskGetChangedFieldsSinceRevision { entities { task { getChangedFieldsSinceRevision(id: "<task id>", revision: 10) } } }` `curl 'https://{region}.api.coevera.com/api/v100/app/space/{space_id}/graphql/public' \ --user "$COEVERA_API_KEY:$COEVERA_API_SECRET" \ --header 'Content-Type: application/json' \ --data '{"query":"query TaskGetChangedFieldsSinceRevision { entities { task { getChangedFieldsSinceRevision(id: \"<task id>\", revision: 10) } } }"}'`
QUERY	`getBySession`(includedIds: [UUID!]!, excludedIds: [UUID!]!, sessionId: String!, before: String, after: String, first: Int, last: Int) Returns a page of records selected in a list or report: all records of the given result plus the explicitly included ids, minus the excluded ids.	TaskEntityConnection
Example Example: getBySessionGraphQLcURL `query TaskGetBySession { entities { task { getBySession( includedIds: ["<task id>"] excludedIds: ["<task id>"] sessionId: "<session id>" first: 10 ) { totalCount edges { node { id formattedName subject modified } } pageInfo { hasNextPage endCursor } } } } }` `curl 'https://{region}.api.coevera.com/api/v100/app/space/{space_id}/graphql/public' \ --user "$COEVERA_API_KEY:$COEVERA_API_SECRET" \ --header 'Content-Type: application/json' \ --data '{"query":"query TaskGetBySession { entities { task { getBySession( includedIds: [\"<task id>\"] excludedIds: [\"<task id>\"] sessionId: \"<session id>\" first: 10 ) { totalCount edges { node { id formattedName subject modified } } pageInfo { hasNextPage endCursor } } } } }"}'`
QUERY	`getByIdFormatted`(id: UUID!, fieldIds: [UUID!]) Returns the values of a record's fields formatted for display, keyed by field id.	JSONString
Example Example: getByIdFormattedGraphQLcURL `query TaskGetByIdFormatted { entities { task { getByIdFormatted(id: "<task id>") } } }` `curl 'https://{region}.api.coevera.com/api/v100/app/space/{space_id}/graphql/public' \ --user "$COEVERA_API_KEY:$COEVERA_API_SECRET" \ --header 'Content-Type: application/json' \ --data '{"query":"query TaskGetByIdFormatted { entities { task { getByIdFormatted(id: \"<task id>\") } } }"}'`
QUERY	`autoPrefill`(mappingId: UUID!, entityId: UUID!, targetEntityTypeId: UUID) Returns a new, unsaved record pre-filled from a source record according to a field mapping. Nothing is saved; the returned values can be used as input for create.	TaskEntity!
Example Example: autoPrefillGraphQLcURL `query TaskAutoPrefill { entities { task { autoPrefill(mappingId: "<mapping id>", entityId: "<task id>") { id formattedName subject modified } } } }` `curl 'https://{region}.api.coevera.com/api/v100/app/space/{space_id}/graphql/public' \ --user "$COEVERA_API_KEY:$COEVERA_API_SECRET" \ --header 'Content-Type: application/json' \ --data '{"query":"query TaskAutoPrefill { entities { task { autoPrefill(mappingId: \"<mapping id>\", entityId: \"<task id>\") { id formattedName subject modified } } } }"}'`
QUERY	`aiAutoPrefill`(actionId: String!) Returns an unsaved record pre-filled with the values proposed by an AI record suggestion, together with the fields the suggestion filled in.	TaskAutoPrefill!
Example Example: aiAutoPrefillGraphQLcURL `query TaskAiAutoPrefill { entities { task { aiAutoPrefill(actionId: "<action id>") { entity { id formattedName subject modified } fieldIds } } } }` `curl 'https://{region}.api.coevera.com/api/v100/app/space/{space_id}/graphql/public' \ --user "$COEVERA_API_KEY:$COEVERA_API_SECRET" \ --header 'Content-Type: application/json' \ --data '{"query":"query TaskAiAutoPrefill { entities { task { aiAutoPrefill(actionId: \"<action id>\") { entity { id formattedName subject modified } fieldIds } } } }"}'`
QUERY	`autoPrefillFromEmail`(emailId: UUID!, mailboxId: UUID) Returns a new, unsaved task pre-filled from an email conversation: subject and description from the last sent email of the conversation that the user can read, the records linked to the conversation (including ones the …	TaskAutoPrefill!
Example Example: autoPrefillFromEmailGraphQLcURL `query TaskAutoPrefillFromEmail { entities { task { autoPrefillFromEmail(emailId: "<email id>") { entity { id formattedName subject modified } fieldIds } } } }` `curl 'https://{region}.api.coevera.com/api/v100/app/space/{space_id}/graphql/public' \ --user "$COEVERA_API_KEY:$COEVERA_API_SECRET" \ --header 'Content-Type: application/json' \ --data '{"query":"query TaskAutoPrefillFromEmail { entities { task { autoPrefillFromEmail(emailId: \"<email id>\") { entity { id formattedName subject modified } fieldIds } } } }"}'`

Mutations

Kind	Mutation	Does	Returns
MUTATION	`changeOwnershipTask`(input: ChangeOwnershipTaskInput!)	Change owner GraphQL only	ChangeOwnershipTaskPayload
Example Example: changeOwnershipTaskGraphQLcURL `mutation ChangeOwnershipTask { changeOwnershipTask( input: {ownerId: "<owner id>", unitId: "<unit id>", keepOwnerAsEditor: false, id: "<task id>"} ) { result { id formattedName subject modified } } }` `curl 'https://{region}.api.coevera.com/api/v100/app/space/{space_id}/graphql/public' \ --user "$COEVERA_API_KEY:$COEVERA_API_SECRET" \ --header 'Content-Type: application/json' \ --data '{"query":"mutation ChangeOwnershipTask { changeOwnershipTask( input: {ownerId: \"<owner id>\", unitId: \"<unit id>\", keepOwnerAsEditor: false, id: \"<task id>\"} ) { result { id formattedName subject modified } } }"}'`
MUTATION	`releaseOwnershipTask`(input: ReleaseOwnershipTaskInput!)	Release ownership GraphQL only	ReleaseOwnershipTaskPayload
Example Example: releaseOwnershipTaskGraphQLcURL `mutation ReleaseOwnershipTask { releaseOwnershipTask(input: {id: "<task id>"}) { result { id formattedName subject modified } } }` `curl 'https://{region}.api.coevera.com/api/v100/app/space/{space_id}/graphql/public' \ --user "$COEVERA_API_KEY:$COEVERA_API_SECRET" \ --header 'Content-Type: application/json' \ --data '{"query":"mutation ReleaseOwnershipTask { releaseOwnershipTask(input: {id: \"<task id>\"}) { result { id formattedName subject modified } } }"}'`
MUTATION	`manageSharingTask`(input: ManageSharingTaskInput!)	Change who it is shared with GraphQL only	ManageSharingTaskPayload
Example Example: manageSharingTaskGraphQLcURL `mutation ManageSharingTask { manageSharingTask(input: {shareMode: Standard, id: "<task id>"}) { result { id formattedName subject modified } } }` `curl 'https://{region}.api.coevera.com/api/v100/app/space/{space_id}/graphql/public' \ --user "$COEVERA_API_KEY:$COEVERA_API_SECRET" \ --header 'Content-Type: application/json' \ --data '{"query":"mutation ManageSharingTask { manageSharingTask(input: {shareMode: Standard, id: \"<task id>\"}) { result { id formattedName subject modified } } }"}'`
MUTATION	`restoreTask`(input: RestoreTaskInput!)	Restore a deleted record	RestoreTaskPayload
Example Example: restoreTaskGraphQLcURL `mutation RestoreTask { restoreTask(input: {id: "<task id>"}) { result { id formattedName subject modified } } }` `curl 'https://{region}.api.coevera.com/api/v100/app/space/{space_id}/graphql/public' \ --user "$COEVERA_API_KEY:$COEVERA_API_SECRET" \ --header 'Content-Type: application/json' \ --data '{"query":"mutation RestoreTask { restoreTask(input: {id: \"<task id>\"}) { result { id formattedName subject modified } } }"}'`
MUTATION	`setReminderTask`(input: SetReminderTaskInput!)	Set a reminder GraphQL only	SetReminderTaskPayload
Example Example: setReminderTaskGraphQLcURL `mutation SetReminderTask { setReminderTask(input: {id: "<task id>"}) { result { id formattedName subject modified } } }` `curl 'https://{region}.api.coevera.com/api/v100/app/space/{space_id}/graphql/public' \ --user "$COEVERA_API_KEY:$COEVERA_API_SECRET" \ --header 'Content-Type: application/json' \ --data '{"query":"mutation SetReminderTask { setReminderTask(input: {id: \"<task id>\"}) { result { id formattedName subject modified } } }"}'`
MUTATION	`removeReminderTask`(input: RemoveReminderTaskInput!)	Remove the reminder GraphQL only	RemoveReminderTaskPayload
Example Example: removeReminderTaskGraphQLcURL `mutation RemoveReminderTask { removeReminderTask(input: {id: "<task id>"}) { result { id formattedName subject modified } } }` `curl 'https://{region}.api.coevera.com/api/v100/app/space/{space_id}/graphql/public' \ --user "$COEVERA_API_KEY:$COEVERA_API_SECRET" \ --header 'Content-Type: application/json' \ --data '{"query":"mutation RemoveReminderTask { removeReminderTask(input: {id: \"<task id>\"}) { result { id formattedName subject modified } } }"}'`
MUTATION	`setTaskStatus`(input: SetTaskStatusInput!)	Changes the status of the task, for example to InProgress or Completed. GraphQL only	SetTaskStatusPayload
Example Example: setTaskStatusGraphQLcURL `mutation SetTaskStatus { setTaskStatus(input: {newStatus: NotStarted, id: "<task id>"}) { result { id formattedName subject modified } } }` `curl 'https://{region}.api.coevera.com/api/v100/app/space/{space_id}/graphql/public' \ --user "$COEVERA_API_KEY:$COEVERA_API_SECRET" \ --header 'Content-Type: application/json' \ --data '{"query":"mutation SetTaskStatus { setTaskStatus(input: {newStatus: NotStarted, id: \"<task id>\"}) { result { id formattedName subject modified } } }"}'`
MUTATION	`createTask`(input: CreateTaskInput!, validationLevel: [ValidationLevel!])	Create one record	CreateTaskPayload
Example Example: createTaskGraphQLcURL `mutation CreateTask { createTask(input: {subject: "Call Northwind Analytics"}) { task { id formattedName subject modified } } }` `curl 'https://{region}.api.coevera.com/api/v100/app/space/{space_id}/graphql/public' \ --user "$COEVERA_API_KEY:$COEVERA_API_SECRET" \ --header 'Content-Type: application/json' \ --data '{"query":"mutation CreateTask { createTask(input: {subject: \"Call Northwind Analytics\"}) { task { id formattedName subject modified } } }"}'`
MUTATION	`updateTask`(input: UpdateTaskInput!, validationLevel: [ValidationLevel!], sessionIdToUpdate: String)	Update fields	UpdateTaskPayload
Example Example: updateTaskGraphQLcURL `mutation UpdateTask { updateTask(input: {id: "<task id>"}) { task { id formattedName subject modified } } }` `curl 'https://{region}.api.coevera.com/api/v100/app/space/{space_id}/graphql/public' \ --user "$COEVERA_API_KEY:$COEVERA_API_SECRET" \ --header 'Content-Type: application/json' \ --data '{"query":"mutation UpdateTask { updateTask(input: {id: \"<task id>\"}) { task { id formattedName subject modified } } }"}'`
MUTATION	`bulkUpdateTask`(input: [CreateOrUpdateTaskInput!]!, deleteInput: [DeleteTaskInput!], validationLevel: [ValidationLevel!], rollbackMethod: RollbackMethod, match: MatchingInput)	Create or update many; per-item results	BulkUpdateTaskPayload
Example Example: bulkUpdateTaskGraphQLcURL `mutation BulkUpdateTask { bulkUpdateTask(input: [{id: "<task id>"}]) { result { created { id } errors { index code message entityId } updated deleted errorsOnDelete { index code message entityId } } } }` `curl 'https://{region}.api.coevera.com/api/v100/app/space/{space_id}/graphql/public' \ --user "$COEVERA_API_KEY:$COEVERA_API_SECRET" \ --header 'Content-Type: application/json' \ --data '{"query":"mutation BulkUpdateTask { bulkUpdateTask(input: [{id: \"<task id>\"}]) { result { created { id } errors { index code message entityId } updated deleted errorsOnDelete { index code message entityId } } } }"}'`
MUTATION	`deleteTask`(input: DeleteTaskInput!)	Soft-delete	DeleteTaskPayload
Example Example: deleteTaskGraphQLcURL `mutation DeleteTask { deleteTask(input: {id: "<task id>"}) { task { id formattedName subject modified } } }` `curl 'https://{region}.api.coevera.com/api/v100/app/space/{space_id}/graphql/public' \ --user "$COEVERA_API_KEY:$COEVERA_API_SECRET" \ --header 'Content-Type: application/json' \ --data '{"query":"mutation DeleteTask { deleteTask(input: {id: \"<task id>\"}) { task { id formattedName subject modified } } }"}'`
MUTATION	`convertTask`(input: CreateTaskInput!, sourceEntity: EntityNameEnum!, sourceEntityId: UUID!, operation: RecordConversionOperationEnum!, options: RecordConversionOptions!, sourceEntityApiName: String, validationLevel: [ValidationLevel!])	Create from another record GraphQL only	ConvertTaskPayload
Example Example: convertTaskGraphQLcURL `mutation ConvertTask { convertTask( input: {subject: "Call Northwind Analytics"} sourceEntity: AiAgent sourceEntityId: "<source entity id>" operation: Nothing options: {} ) { task { id formattedName subject modified } } }` `curl 'https://{region}.api.coevera.com/api/v100/app/space/{space_id}/graphql/public' \ --user "$COEVERA_API_KEY:$COEVERA_API_SECRET" \ --header 'Content-Type: application/json' \ --data '{"query":"mutation ConvertTask { convertTask( input: {subject: \"Call Northwind Analytics\"} sourceEntity: AiAgent sourceEntityId: \"<source entity id>\" operation: Nothing options: {} ) { task { id formattedName subject modified } } }"}'`

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.

TaskEntity object 58 fields: customFields, pendingScheduledActions, isDeleteProtected, …

Task (e.g. a to-do or a call) owned by a user, with an optional due date, and linked to records.

Field	Type	Description
`customFields`	JSONString! (1 args)	Values of the record's custom fields as a JSON object keyed by custom field apiName (camelCase).
`pendingScheduledActions`	Int	Filled only when a single record is read by its id; otherwise null or an empty list.
`isDeleteProtected`	Boolean!	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.
`id`	ID!	Unique identifier of entity.
`activeReminder`	String	Timestamp of the next pending reminder configured for the activity (reminder time, due date or end date as applicable). Empty when no reminder is pending.
`mediaTranscriptionId`	UUID	Id of the linked Media record holding the activity's call recording / transcription, when available.
`isDeleted`	Boolean	Specifies if the entity is considered deleted.
`modified`	DateTime	Last modification time.
`created`	DateTime	Creation time.
`activityType`	TaskTypeEntity	Task type that classifies this task (e.g. Task, Call, Email). Drives form layout and icon.
`call`	CallEntity	Call record associated with this task when the task represents a phone call.
`callOutcome`	DataEntity	Configurable outcome of the call (e.g. Reached, Voicemail, No Answer).
`currencyExchangeRatesList`	CurrencyExchangeRatesListEntity	Currency exchange rate list used to convert monetary fields linked to this task. Empty to inherit the team space default.
`owner`	ClientEntity	Sales user who owns this task. May be empty when the task is unassigned and available for take-over.
`unit`	SalesUnitEntity	Sales unit this task is assigned to. Determines which team members can see the record under unit-based sharing.
`activityTypeId`	ID	Id of the task type.
`callDuration`	Int	Duration of the recorded call. Set automatically when the task is linked to a call log.
`callId`	ID	Id of the linked call record.
`callOutcomeId`	ID	Id of the call outcome option recorded for the call (e.g. Reached, Voicemail, No Answer).
`currencyExchangeRatesListId`	ID	Id of the currency exchange rate list applied to this task.
`description`	String	Free-form description of what the task entails.
`dueDate`	Date	Date by which the task is expected to be completed.
`duration`	Float	Estimated duration of the task. Stored as a duration value (days/hours/minutes).
`ownerId`	ID	Id of the task owner.
`priority`	PriorityEnum	Priority level of the task: Low, Medium or High.
`shareMode`	ShareModeEnum	Sharing model applied on top of the owner/unit visibility (e.g. shared with selected sales units or selected users).
`startDate`	Date	Date when work on the task is scheduled to begin.
`status`	TaskStatusEnum	Current status of the task (NotStarted, InProgress, Waiting, Completed, Deferred). Toggling to Completed marks any linked checklist items as done.
`subject`	String!	Short summary line shown in lists and notifications.
`tableName`	String!	Discriminator identifying the concrete record type — always "task" for Task records. Read-only; useful when consuming polymorphic Activity results.
`unitId`	ID	Id of the sales unit.
`revision`	Int	Revision when entity was lastly changed.
`sharingUnits`	TaskSharingSalesUnitRelationEntityConnection (8 args)	Sales units that have been granted shared access to this task. Editable only when shareMode allows unit sharing.
`sharingClients`	TaskSharingClientRelationEntityConnection (8 args)	Users that have been granted shared access to this task. Editable only when shareMode allows user sharing.
`accountRelations`	ActivityRelationEntityConnection (8 args)	Accounts this task is linked to.
`contactRelations`	ActivityRelationEntityConnection (8 args)	Contacts this task is linked to.
`leadRelations`	ActivityRelationEntityConnection (8 args)	Leads this task is linked to.
`opportunityRelations`	ActivityRelationEntityConnection (8 args)	Opportunities this task is linked to.
`projectRelations`	ActivityRelationEntityConnection (8 args)	Projects this task is linked to, including the per-objective ordering.
`quoteRelations`	ActivityRelationEntityConnection (8 args)	Quotes this task is linked to.
`customEntityRelations`	ActivityRelationEntityConnection (8 args)	Custom entity records this task is linked to.
`exchangeEntityId`	String	External identifier of the record in the linked third-party service (e.g. Google, Microsoft 365, Exchange). Maintained by the sync engine.
`gapiEntityId`	String	External identifier of the record in the linked third-party service (e.g. Google, Microsoft 365, Exchange). Maintained by the sync engine.
`o365EntityId`	String	External identifier of the record in the linked third-party service (e.g. Google, Microsoft 365, Exchange). Maintained by the sync engine.
`reminder`	TaskReminderEntity	Reminder set by the current authenticated user for this task. Per-user; empty when no reminder has been set.
`taskRecurrence`	TaskRecurrenceEntity	Recurrence schedule generating periodic copies of this task, or empty when no recurrence is set up.
`documents`	CloudObjectRelationEntityConnection (8 args)	Documents linked to this task.
`comments`	ActivityCommentEntityConnection (7 args)	Comments authored on this task.
`tags`	TagRelationEntityConnection (8 args)	Tag labels applied to this task.
`formattedName`	String!	Display name of the task (alias of subject).
`viewerIdsPerSalesUnit`	[UUID!]!	Filled only when a single record is read by its id; otherwise null or an empty list.
`modifiedByUser`	DateTime	Timestamp of the most recent modification made by an end user (excluding system changes). Read-only; computed by Coevera.
`instancePermissions`	[EntityPermsEnum!]! (1 args)	Permissions the current user has on this record, out of the requested ones.
`relatedEntitiesDrilldown`	CompactViewDrilldownModel! (1 args)	Records of the given entity type that are related to this record, as a drilldown list.
`charts`	[DashboardChartData!] (1 args)	Data of the given preview pane charts and lists, computed for this record.
`chartsDrilldown`	CompactViewDrilldownModel! (3 args)	Records behind one preview pane chart of this record: all records of a list chart, or the records of a single data point of a report chart.
`fields`	[InterfaceFieldData]! (2 args)	Values of the fields shown in the record's preview pane, as configured for the record's type.
`mediaTranscription`	MediaEntity	Recording attached to this activity, with its transcription and summary when available; null when there is none.

TaskEntityConnection object pageInfo: PageInfo!, edges: [TaskEntityEdge]!, totalCount: Int

Paginated list of Task records.

Field	Type	Description
`pageInfo`	PageInfo!	Pagination data for this connection.
`edges`	[TaskEntityEdge]!	Contains the nodes in this connection.
`totalCount`	Int	Total number of items in the connection.

TaskEntityEdge object node: TaskEntity, cursor: String!

A Relay edge containing a TaskEntity and its cursor.

Field	Type	Description
`node`	TaskEntity	The item at the end of the edge
`cursor`	String!	A cursor for use in pagination

PriorityEnumFilterInput input eq: [PriorityEnum!], NOT: PriorityEnumFilterInput

Conditions on an enumeration field. Several conditions given together must all match.

Input field	Type	Description
`eq`	[PriorityEnum!]	Matches any of the listed values.
`NOT`	PriorityEnumFilterInput	Matches values that do not meet this condition.

TaskFilterInput input AND, OR, NOT, globalSearchQuery, one condition per field

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

Input field	Type	Description
`OR`	[TaskFilterInput!]	Matches records that meet at least one of the listed filters.
`AND`	[TaskFilterInput!]	Matches records that meet all of the listed filters.
`NOT`	TaskFilterInput	Matches records that do not meet this filter.
`globalSearchQuery`	String	Search term matched against the fields that the global search covers for this entity.
`id`	EntityFilterStringField	Unique identifier of entity.
`isDeleted`	Boolean	Specifies if the entity is considered deleted.
`modified`	EntityFilterDateTimeField	Last modification time.
`created`	EntityFilterDateTimeField	Creation time.
`activityTypeId`	EntityFilterStringField	Id of the task type.
`callDuration`	EntityFilterNumberField	Duration of the recorded call. Set automatically when the task is linked to a call log.
`callId`	EntityFilterStringField	Id of the linked call record.
`callOutcomeId`	EntityFilterStringField	Id of the call outcome option recorded for the call (e.g. Reached, Voicemail, No Answer).
`currencyExchangeRatesListId`	EntityFilterStringField	Id of the currency exchange rate list applied to this task.
`description`	EntityFilterStringField	Free-form description of what the task entails.
`duration`	EntityFilterNumberField	Estimated duration of the task. Stored as a duration value (days/hours/minutes).
`ownerId`	EntityFilterStringField	Id of the task owner.
`priority`	PriorityEnumFilterInput	Priority level of the task: Low, Medium or High.
`shareMode`	ShareModeEnumFilterInput	Sharing model applied on top of the owner/unit visibility (e.g. shared with selected sales units or selected users).
`status`	TaskStatusEnumFilterInput	Current status of the task (NotStarted, InProgress, Waiting, Completed, Deferred). Toggling to Completed marks any linked checklist items as done.
`subject`	EntityFilterStringField	Short summary line shown in lists and notifications.
`tableName`	EntityFilterStringField	Discriminator identifying the concrete record type — always "task" for Task records. Read-only; useful when consuming polymorphic Activity results.
`unitId`	EntityFilterStringField	Id of the sales unit.
`revision`	EntityFilterNumberField	Revision when entity was lastly changed.
`exchangeEntityId`	String	External identifier of the record in the linked third-party service (e.g. Google, Microsoft 365, Exchange). Maintained by the sync engine.
`gapiEntityId`	String	External identifier of the record in the linked third-party service (e.g. Google, Microsoft 365, Exchange). Maintained by the sync engine.
`o365EntityId`	String	External identifier of the record in the linked third-party service (e.g. Google, Microsoft 365, Exchange). Maintained by the sync engine.
`withCustom`	[CustomField!]	Conditions on custom fields, each identified by its api name. All listed conditions must match.
`activityType`	TaskTypeFilterInput	Task type that classifies this task (e.g. Task, Call, Email). Drives form layout and icon. Matches records where a related record meets these conditions.
`call`	CallFilterInput	Call record associated with this task when the task represents a phone call. Matches records where a related record meets these conditions.
`callOutcome`	DataFilterInput	Configurable outcome of the call (e.g. Reached, Voicemail, No Answer). Matches records where a related record meets these conditions.
`currencyExchangeRatesList`	CurrencyExchangeRatesListFilterInput	Currency exchange rate list used to convert monetary fields linked to this task. Empty to inherit the team space default. Matches records where a related record meets these conditions.
`owner`	ClientFilterInput	Sales user who owns this task. May be empty when the task is unassigned and available for take-over. Matches records where a related record meets these conditions.
`unit`	SalesUnitFilterInput	Sales unit this task is assigned to. Determines which team members can see the record under unit-based sharing. Matches records where a related record meets these conditions.
`sharingUnits`	TaskSharingSalesUnitRelationFilterInput	Sales units that have been granted shared access to this task. Editable only when shareMode allows unit sharing. Matches records where a related record meets these conditions.
`sharingClients`	TaskSharingClientRelationFilterInput	Users that have been granted shared access to this task. Editable only when shareMode allows user sharing. Matches records where a related record meets these conditions.
`accountRelations`	ActivityRelationFilterInput	Accounts this task is linked to. Matches records where a related record meets these conditions.
`contactRelations`	ActivityRelationFilterInput	Contacts this task is linked to. Matches records where a related record meets these conditions.
`leadRelations`	ActivityRelationFilterInput	Leads this task is linked to. Matches records where a related record meets these conditions.
`opportunityRelations`	ActivityRelationFilterInput	Opportunities this task is linked to. Matches records where a related record meets these conditions.
`projectRelations`	ActivityRelationFilterInput	Projects this task is linked to, including the per-objective ordering. Matches records where a related record meets these conditions.
`quoteRelations`	ActivityRelationFilterInput	Quotes this task is linked to. Matches records where a related record meets these conditions.
`customEntityRelations`	ActivityRelationFilterInput	Custom entity records this task is linked to. Matches records where a related record meets these conditions.
`reminder`	TaskReminderFilterInput	Reminder set by the current authenticated user for this task. Per-user; empty when no reminder has been set. Matches records where a related record meets these conditions.
`taskRecurrence`	TaskRecurrenceFilterInput	Recurrence schedule generating periodic copies of this task, or empty when no recurrence is set up. Matches records where a related record meets these conditions.
`documents`	CloudObjectRelationFilterInput	Documents linked to this task. Matches records where a related record meets these conditions.
`comments`	ActivityCommentFilterInput	Comments authored on this task. Matches records where a related record meets these conditions.
`tags`	TagRelationFilterInput	Tag labels applied to this task. Matches records where a related record meets these conditions.

TaskOrderByInput input Asc or Desc per field

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

Input field	Type	Description
`id`	OrderByEnum	Unique identifier of entity.
`isDeleted`	OrderByEnum	Specifies if the entity is considered deleted.
`modified`	OrderByEnum	Last modification time.
`created`	OrderByEnum	Creation time.
`activityType`	[TaskTypeOrderByNestedInput!]	Task type that classifies this task (e.g. Task, Call, Email). Drives form layout and icon. Sorts by fields of the related record, listed in order of priority.
`call`	[CallOrderByNestedInput!]	Call record associated with this task when the task represents a phone call. Sorts by fields of the related record, listed in order of priority.
`callOutcome`	[DataOrderByNestedInput!]	Configurable outcome of the call (e.g. Reached, Voicemail, No Answer). Sorts by fields of the related record, listed in order of priority.
`currencyExchangeRatesList`	[CurrencyExchangeRatesListOrderByNestedInput!]	Currency exchange rate list used to convert monetary fields linked to this task. Empty to inherit the team space default. Sorts by fields of the related record, listed in order of priority.
`owner`	[ClientOrderByNestedInput!]	Sales user who owns this task. May be empty when the task is unassigned and available for take-over. Sorts by fields of the related record, listed in order of priority.
`unit`	[SalesUnitOrderByNestedInput!]	Sales unit this task is assigned to. Determines which team members can see the record under unit-based sharing. Sorts by fields of the related record, listed in order of priority.
`activityTypeId`	OrderByEnum	Id of the task type.
`callDuration`	OrderByEnum	Duration of the recorded call. Set automatically when the task is linked to a call log.
`callId`	OrderByEnum	Id of the linked call record.
`callOutcomeId`	OrderByEnum	Id of the call outcome option recorded for the call (e.g. Reached, Voicemail, No Answer).
`currencyExchangeRatesListId`	OrderByEnum	Id of the currency exchange rate list applied to this task.
`description`	OrderByEnum	Free-form description of what the task entails.
`dueDate`	OrderByEnum	Date by which the task is expected to be completed.
`duration`	OrderByEnum	Estimated duration of the task. Stored as a duration value (days/hours/minutes).
`ownerId`	OrderByEnum	Id of the task owner.
`priority`	OrderByEnum	Priority level of the task: Low, Medium or High.
`shareMode`	OrderByEnum	Sharing model applied on top of the owner/unit visibility (e.g. shared with selected sales units or selected users).
`startDate`	OrderByEnum	Date when work on the task is scheduled to begin.
`subject`	OrderByEnum	Short summary line shown in lists and notifications.
`unitId`	OrderByEnum	Id of the sales unit.
`revision`	OrderByEnum	Revision when entity was lastly changed.
`exchangeEntityId`	OrderByEnum	External identifier of the record in the linked third-party service (e.g. Google, Microsoft 365, Exchange). Maintained by the sync engine.
`gapiEntityId`	OrderByEnum	External identifier of the record in the linked third-party service (e.g. Google, Microsoft 365, Exchange). Maintained by the sync engine.
`o365EntityId`	OrderByEnum	External identifier of the record in the linked third-party service (e.g. Google, Microsoft 365, Exchange). Maintained by the sync engine.
`reminder`	[TaskReminderOrderByNestedInput!]	Reminder set by the current authenticated user for this task. Per-user; empty when no reminder has been set. Sorts by fields of the related record, listed in order of priority.
`taskRecurrence`	[TaskRecurrenceOrderByNestedInput!]	Recurrence schedule generating periodic copies of this task, or empty when no recurrence is set up. Sorts by fields of the related record, listed in order of priority.
`withCustom`	CommonEntityRepositoryOrderByCustomField	Sorts by a custom field.

TaskStatusEnumFilterInput input eq: [TaskStatusEnum!], NOT: TaskStatusEnumFilterInput

Conditions on an enumeration field. Several conditions given together must all match.

Input field	Type	Description
`eq`	[TaskStatusEnum!]	Matches any of the listed values.
`NOT`	TaskStatusEnumFilterInput	Matches values that do not meet this condition.

ChangeOwnershipTaskInput input 5 fields: ownerId, unitId, keepOwnerAsEditor, …

Parameters of the changeOwnershipTask mutation.

Input field	Type	Description
`ownerId`	ID!	User who becomes the new owner of the task.
`unitId`	ID!	Sales unit the task is assigned to.
`keepOwnerAsEditor`	Boolean!	When true, the previous owner (if still an active user) stays on the task as a shared user with the Editor role, and a Private sharing mode is switched to Standard.
`id`	ID!	Identifier of the TaskEntity to perform the action on.
`clientMutationId`	String	Optional 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).

CreateOrUpdateTaskInput input 40 fields: clientMutationId, id, mediaTranscriptionId, …

Field values of a Task record to create, or to update when its id is set.

Input field	Type	Description
`clientMutationId`	String	Optional 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).
`id`	ID	Unique identifier of entity.
`mediaTranscriptionId`	UUID	Id of the linked Media record holding the activity's call recording / transcription, when available.
`modified`	DateTime	Last modification time.
`created`	DateTime	Creation time.
`activityTypeId`	ID	Id of the task type.
`callDuration`	Int	Duration of the recorded call. Set automatically when the task is linked to a call log.
`callId`	ID	Id of the linked call record.
`callOutcomeId`	ID	Id of the call outcome option recorded for the call (e.g. Reached, Voicemail, No Answer).
`currencyExchangeRatesListId`	ID	Id of the currency exchange rate list applied to this task.
`description`	String	Free-form description of what the task entails.
`dueDate`	Date	Date by which the task is expected to be completed.
`duration`	Float	Estimated duration of the task. Stored as a duration value (days/hours/minutes).
`ownerId`	ID	Id of the task owner.
`priority`	PriorityEnum	Priority level of the task: Low, Medium or High.
`shareMode`	ShareModeEnum	Sharing model applied on top of the owner/unit visibility (e.g. shared with selected sales units or selected users).
`startDate`	Date	Date when work on the task is scheduled to begin.
`status`	TaskStatusEnum	Current status of the task (NotStarted, InProgress, Waiting, Completed, Deferred). Toggling to Completed marks any linked checklist items as done.
`subject`	String	Short summary line shown in lists and notifications.
`unitId`	ID	Id of the sales unit.
`customFields`	JSONString	Custom field values to set, as a JSON object keyed by custom field API name, e.g. {"cfBudget": 1000}. Only the custom fields included are changed; each value uses the format of that field.
`revision`	Int	Revision when entity was lastly changed.
`sharingUnits`	[CreateTaskSharingSalesUnitRelationNoTaskBackrefInput!]	Sales units that have been granted shared access to this task. Editable only when shareMode allows unit sharing.
`sharingClients`	[CreateTaskSharingClientRelationNoTaskBackrefInput!]	Users that have been granted shared access to this task. Editable only when shareMode allows user sharing.
`accountRelations`	[CreateActivityRelationNoActivityBackrefInput!]	Accounts this task is linked to.
`contactRelations`	[CreateActivityRelationNoActivityBackrefInput!]	Contacts this task is linked to.
`leadRelations`	[CreateActivityRelationNoActivityBackrefInput!]	Leads this task is linked to.
`opportunityRelations`	[CreateActivityRelationNoActivityBackrefInput!]	Opportunities this task is linked to.
`projectRelations`	[CreateActivityRelationNoActivityBackrefInput!]	Projects this task is linked to, including the per-objective ordering.
`quoteRelations`	[CreateActivityRelationNoActivityBackrefInput!]	Quotes this task is linked to.
`customEntityRelations`	[CreateActivityRelationNoActivityBackrefInput!]	Custom entity records this task is linked to.
`exchangeEntityId`	String	External identifier of the record in the linked third-party service (e.g. Google, Microsoft 365, Exchange). Maintained by the sync engine.
`gapiEntityId`	String	External identifier of the record in the linked third-party service (e.g. Google, Microsoft 365, Exchange). Maintained by the sync engine.
`o365EntityId`	String	External identifier of the record in the linked third-party service (e.g. Google, Microsoft 365, Exchange). Maintained by the sync engine.
`reminder`	UpdateTaskReminderNoTaskBackrefInput	Reminder set by the current authenticated user for this task. Per-user; empty when no reminder has been set.
`taskRecurrence`	UpdateTaskRecurrenceNoTaskBackrefInput	Recurrence schedule generating periodic copies of this task, or empty when no recurrence is set up.
`documents`	[CreateCloudObjectRelationNoBackrefInput!]	Documents linked to this task.
`comments`	[CreateActivityCommentNoActivityBackrefInput!]	Comments authored on this task.
`tags`	[CreateTagRelationNoTaskBackrefInput!]	Tag labels applied to this task.
`callSid`	String	Identifier (SID) of a phone call made through Coevera calling, to attach that call to the task; null detaches the call. Write-only.

CreateTagRelationNoTaskBackrefInput input 15 fields: modified, created, accountId, …

Field values of a new TagRelation record, created together with the record it belongs to.

Input field	Type	Description
`modified`	DateTime	Last modification time.
`created`	DateTime	Creation time.
`accountId`	ID	Id of the linked account.
`appointmentId`	ID	Id of the linked appointment.
`contactId`	ID	Id of the linked contact.
`customEntityId`	ID	Id of the linked custom entity record.
`emailId`	ID	Id of the linked email.
`leadId`	ID	Id of the linked lead.
`opptyId`	ID	Id of the linked opportunity.
`processId`	ID	Id of the linked sales process.
`projectId`	ID	Id of the linked project.
`quoteId`	ID	Id of the linked quote.
`solutionId`	ID	Id of the linked solution.
`tagId`	ID!	Id of the tag attached to the record.
`revision`	Int	Revision when entity was lastly changed.

CreateTaskInput input 36 fields: clientMutationId, mediaTranscriptionId, modified, …

Field values of a new Task record.

Input field	Type	Description
`clientMutationId`	String	Optional 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).
`mediaTranscriptionId`	UUID	Id of the linked Media record holding the activity's call recording / transcription, when available.
`modified`	DateTime	Last modification time.
`created`	DateTime	Creation time.
`activityTypeId`	ID	Id of the task type.
`callDuration`	Int	Duration of the recorded call. Set automatically when the task is linked to a call log.
`callId`	ID	Id of the linked call record.
`callOutcomeId`	ID	Id of the call outcome option recorded for the call (e.g. Reached, Voicemail, No Answer).
`currencyExchangeRatesListId`	ID	Id of the currency exchange rate list applied to this task.
`description`	String	Free-form description of what the task entails.
`dueDate`	Date	Date by which the task is expected to be completed.
`duration`	Float	Estimated duration of the task. Stored as a duration value (days/hours/minutes).
`ownerId`	ID	Id of the task owner.
`priority`	PriorityEnum	Priority level of the task: Low, Medium or High.
`shareMode`	ShareModeEnum	Sharing model applied on top of the owner/unit visibility (e.g. shared with selected sales units or selected users).
`startDate`	Date	Date when work on the task is scheduled to begin.
`status`	TaskStatusEnum	Current status of the task (NotStarted, InProgress, Waiting, Completed, Deferred). Toggling to Completed marks any linked checklist items as done.
`subject`	String!	Short summary line shown in lists and notifications.
`unitId`	ID	Id of the sales unit.
`customFields`	JSONString	Custom field values to set, as a JSON object keyed by custom field API name, e.g. {"cfBudget": 1000}. Only the custom fields included are changed; each value uses the format of that field.
`revision`	Int	Revision when entity was lastly changed.
`sharingUnits`	[CreateTaskSharingSalesUnitRelationNoTaskBackrefInput!]	Sales units that have been granted shared access to this task. Editable only when shareMode allows unit sharing.
`sharingClients`	[CreateTaskSharingClientRelationNoTaskBackrefInput!]	Users that have been granted shared access to this task. Editable only when shareMode allows user sharing.
`accountRelations`	[CreateActivityRelationNoActivityBackrefInput!]	Accounts this task is linked to.
`contactRelations`	[CreateActivityRelationNoActivityBackrefInput!]	Contacts this task is linked to.
`leadRelations`	[CreateActivityRelationNoActivityBackrefInput!]	Leads this task is linked to.
`opportunityRelations`	[CreateActivityRelationNoActivityBackrefInput!]	Opportunities this task is linked to.
`projectRelations`	[CreateActivityRelationNoActivityBackrefInput!]	Projects this task is linked to, including the per-objective ordering.
`quoteRelations`	[CreateActivityRelationNoActivityBackrefInput!]	Quotes this task is linked to.
`customEntityRelations`	[CreateActivityRelationNoActivityBackrefInput!]	Custom entity records this task is linked to.
`reminder`	CreateTaskReminderNoTaskBackrefInput	Reminder set by the current authenticated user for this task. Per-user; empty when no reminder has been set.
`taskRecurrence`	CreateTaskRecurrenceNoTaskBackrefInput	Recurrence schedule generating periodic copies of this task, or empty when no recurrence is set up.
`documents`	[CreateCloudObjectRelationNoBackrefInput!]	Documents linked to this task.
`comments`	[CreateActivityCommentNoActivityBackrefInput!]	Comments authored on this task.
`tags`	[CreateTagRelationNoTaskBackrefInput!]	Tag labels applied to this task.
`callSid`	String	Identifier (SID) of a phone call made through Coevera calling, to attach that call to the task; null detaches the call. Write-only.

CreateTaskRecurrenceNoTaskBackrefInput input 13 fields: applyRecurrence, modified, created, …

Field values of a new TaskRecurrence record, created together with the record it belongs to.

Input field	Type	Description
`applyRecurrence`	Boolean	Default true. When set, then reccurence will apply when other conditions passed. With the value false (e.g. when skip button is used) then recurrence will not apply
`modified`	DateTime	Last modification time.
`created`	DateTime	Creation time.
`day`	DateDayEnum	Field whose values are strictly defined with an enumeration of values. The day of the month. This setting is applicable only for RecurrenceTypeEnum.MonthlyRelative and RecurrenceTypeEnum.YearlyRelative.
`dayOfWeek`	Int	Bit Flag field, with limited combination of integer values.
`endDate`	Date	Date information. The last date when no more other items should be created.
`month`	DateMonthEnum	Field whose values are strictly defined with an enumeration of values. The number of month this setting is applicable only for RecurrenceTypeEnum.YearlyAbsolute and RecurrenceTypeEnum.YearlyRelative.
`occurEvery`	Int	The number of units of a given recurrence type between occurrences according to RecurrenceTypeEnum.
`occurrencesCount`	Int	Whole natural number. The number of remaining occurrences. Each time a new one is created, it decreases. When item is set to 1, only last one can be created. If it is set to 0, recurrence is stopped. If -1, no limits are applied.
`startDate`	Date!	Date information. The effective start date of recurrence, which means each next recurrence must be on or after this date.
`type`	RecurrenceTypeEnum	Recurrence cadence (e.g. Daily, Weekly, MonthlyAbsolute, MonthlyRelative, YearlyAbsolute, YearlyRelative, AfterNDays, AfterNWeeks, AfterNMonths, AfterNYears).
`week`	DateWeekEnum	Field whose values are strictly defined with an enumeration of values. The week of month. This setting is applicable only for RecurrenceTypeEnum.MonthlyAbsolute and RecurrenceTypeEnum.YearlyAbsolute.
`revision`	Int	Revision when entity was lastly changed.

CreateTaskReminderNoTaskBackrefInput input 6 fields: modified, created, ownerId, …

Field values of a new TaskReminder record, created together with the record it belongs to.

Input field	Type	Description
`modified`	DateTime	Last modification time.
`created`	DateTime	Creation time.
`ownerId`	ID!	Id of the user who set the reminder.
`setDate`	DateTime!	Timestamp when the reminder should fire.
`status`	ReminderStatusEnum	Current state of the reminder: Scheduled to fire at its set time, Snoozed until snoozeDate, or Dismissed.
`revision`	Int	Revision when entity was lastly changed.

CreateTaskSharingClientRelationNoTaskBackrefInput input 5 fields: modified, created, clientId, …

Field values of a new TaskSharingClientRelation record, created together with the record it belongs to.

Input field	Type	Description
`modified`	DateTime	Last modification time.
`created`	DateTime	Creation time.
`clientId`	ID!	Id of the user.
`role`	SharingRoleEnum	Access the sharing gives the user on the task: Watcher can view it, Editor can view and edit it.
`revision`	Int	Revision when entity was lastly changed.

CreateTaskSharingSalesUnitRelationNoTaskBackrefInput input 5 fields: modified, created, role, …

Field values of a new TaskSharingSalesUnitRelation record, created together with the record it belongs to.

Input field	Type	Description
`modified`	DateTime	Last modification time.
`created`	DateTime	Creation time.
`role`	SharingRoleEnum	Access the sharing gives the sales unit on the task: Watcher can view it, Editor can view and edit it.
`unitId`	ID!	Id of the sales unit.
`revision`	Int	Revision when entity was lastly changed.

DeleteTaskInput input clientMutationId: String, id: ID!

Id of the Task record to delete.

Input field	Type	Description
`clientMutationId`	String	Optional 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).
`id`	ID!	Unique identifier of entity.

ManageSharingTaskInput input 5 fields: shareMode, sharingClients, sharingUnits, …

Parameters of the manageSharingTask mutation.

Input field	Type	Description
`shareMode`	ShareModeEnum!	Sharing mode of the record: Standard, Private, AllView or AllEdit.
`sharingClients`	[CreateTaskSharingClientRelationNoTaskBackrefInput!]	Users the record is shared with, each with the Watcher (view) or Editor (edit) role. Send an empty list to remove all shared users.
`sharingUnits`	[CreateTaskSharingSalesUnitRelationNoTaskBackrefInput!]	Sales units the record is shared with, each with the Watcher or Editor role. Send an empty list to remove all shared units.
`id`	ID!	Identifier of the TaskEntity to perform the action on.
`clientMutationId`	String	Optional 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).

ReleaseOwnershipTaskInput input id: ID!, clientMutationId: String

Parameters of the releaseOwnershipTask mutation.

Input field	Type	Description
`id`	ID!	Identifier of the TaskEntity to perform the action on.
`clientMutationId`	String	Optional 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).

RemoveReminderTaskInput input id: ID!, clientMutationId: String

Parameters of the removeReminderTask mutation.

Input field	Type	Description
`id`	ID!	Identifier of the TaskEntity to perform the action on.
`clientMutationId`	String	Optional 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).

RestoreTaskInput input id: ID!, clientMutationId: String

Parameters of the restoreTask mutation.

Input field	Type	Description
`id`	ID!	Identifier of the TaskEntity to perform the action on.
`clientMutationId`	String	Optional 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).

SetReminderTaskInput input setDate: DateTime, status: ReminderStatusEnum, id: ID!, clientMutationId: String

Parameters of the setReminderTask mutation.

Input field	Type	Description
`setDate`	DateTime	When the reminder fires; also used as the new time when snoozing. When a first reminder is created without a date and without the Scheduled status, it defaults to today at the user's default task reminder time.
`status`	ReminderStatusEnum	State of the reminder: Scheduled, Snoozed or Dismissed. Omit to keep the current state.
`id`	ID!	Identifier of the TaskEntity to perform the action on.
`clientMutationId`	String	Optional 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).

SetTaskStatusInput input newStatus: TaskStatusEnum!, id: ID!, clientMutationId: String

Parameters of the setTaskStatus mutation.

Input field	Type	Description
`newStatus`	TaskStatusEnum!	New status of the task.
`id`	ID!	Identifier of the TaskEntity to perform the action on.
`clientMutationId`	String	Optional 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).

TaskRecurrenceOrderByNestedInput input 15 fields: id, isDeleted, modified, …

Sorting by a field of the related TaskRecurrence record. Set exactly one field in each item.

Input field	Type	Description
`id`	OrderByEnum	Unique identifier of entity.
`isDeleted`	OrderByEnum	Specifies if the entity is considered deleted.
`modified`	OrderByEnum	Last modification time.
`created`	OrderByEnum	Creation time.
`day`	OrderByEnum	Field whose values are strictly defined with an enumeration of values. The day of the month. This setting is applicable only for RecurrenceTypeEnum.MonthlyRelative and RecurrenceTypeEnum.YearlyRelative.
`dayOfWeek`	OrderByEnum	Bit Flag field, with limited combination of integer values.
`endDate`	OrderByEnum	Date information. The last date when no more other items should be created.
`month`	OrderByEnum	Field whose values are strictly defined with an enumeration of values. The number of month this setting is applicable only for RecurrenceTypeEnum.YearlyAbsolute and RecurrenceTypeEnum.YearlyRelative.
`occurEvery`	OrderByEnum	The number of units of a given recurrence type between occurrences according to RecurrenceTypeEnum.
`occurrencesCount`	OrderByEnum	Whole natural number. The number of remaining occurrences. Each time a new one is created, it decreases. When item is set to 1, only last one can be created. If it is set to 0, recurrence is stopped. If -1, no limits are applied.
`startDate`	OrderByEnum	Date information. The effective start date of recurrence, which means each next recurrence must be on or after this date.
`taskId`	OrderByEnum	Id of the parent task.
`type`	OrderByEnum	Recurrence cadence (e.g. Daily, Weekly, MonthlyAbsolute, MonthlyRelative, YearlyAbsolute, YearlyRelative, AfterNDays, AfterNWeeks, AfterNMonths, AfterNYears).
`week`	OrderByEnum	Field whose values are strictly defined with an enumeration of values. The week of month. This setting is applicable only for RecurrenceTypeEnum.MonthlyAbsolute and RecurrenceTypeEnum.YearlyAbsolute.
`revision`	OrderByEnum	Revision when entity was lastly changed.

TaskReminderOrderByNestedInput input 9 fields: id, isDeleted, modified, …

Sorting by a field of the related TaskReminder record. Set exactly one field in each item.

Input field	Type	Description
`id`	OrderByEnum	Unique identifier of entity.
`isDeleted`	OrderByEnum	Specifies if the entity is considered deleted.
`modified`	OrderByEnum	Last modification time.
`created`	OrderByEnum	Creation time.
`ownerId`	OrderByEnum	Id of the user who set the reminder.
`setDate`	OrderByEnum	Timestamp when the reminder should fire.
`status`	OrderByEnum	Current state of the reminder: Scheduled to fire at its set time, Snoozed until snoozeDate, or Dismissed.
`taskId`	OrderByEnum	Id of the task this reminder belongs to.
`revision`	OrderByEnum	Revision when entity was lastly changed.

UpdateTaskInput input 39 fields: clientMutationId, id, mediaTranscriptionId, …

Id of a Task record and the field values to change.

Input field	Type	Description
`clientMutationId`	String	Optional 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).
`id`	ID!	Unique identifier of entity.
`mediaTranscriptionId`	UUID	Id of the linked Media record holding the activity's call recording / transcription, when available.
`modified`	DateTime	Last modification time.
`created`	DateTime	Creation time.
`activityTypeId`	ID	Id of the task type.
`callDuration`	Int	Duration of the recorded call. Set automatically when the task is linked to a call log.
`callId`	ID	Id of the linked call record.
`callOutcomeId`	ID	Id of the call outcome option recorded for the call (e.g. Reached, Voicemail, No Answer).
`currencyExchangeRatesListId`	ID	Id of the currency exchange rate list applied to this task.
`description`	String	Free-form description of what the task entails.
`dueDate`	Date	Date by which the task is expected to be completed.
`duration`	Float	Estimated duration of the task. Stored as a duration value (days/hours/minutes).
`ownerId`	ID	Id of the task owner.
`priority`	PriorityEnum	Priority level of the task: Low, Medium or High.
`shareMode`	ShareModeEnum	Sharing model applied on top of the owner/unit visibility (e.g. shared with selected sales units or selected users).
`startDate`	Date	Date when work on the task is scheduled to begin.
`status`	TaskStatusEnum	Current status of the task (NotStarted, InProgress, Waiting, Completed, Deferred). Toggling to Completed marks any linked checklist items as done.
`subject`	String	Short summary line shown in lists and notifications.
`unitId`	ID	Id of the sales unit.
`customFields`	JSONString	Custom field values to set, as a JSON object keyed by custom field API name, e.g. {"cfBudget": 1000}. Only the custom fields included are changed; each value uses the format of that field.
`revision`	Int	Revision when entity was lastly changed.
`sharingUnits`	[CreateTaskSharingSalesUnitRelationNoTaskBackrefInput!]	Sales units that have been granted shared access to this task. Editable only when shareMode allows unit sharing.
`sharingClients`	[CreateTaskSharingClientRelationNoTaskBackrefInput!]	Users that have been granted shared access to this task. Editable only when shareMode allows user sharing.
`accountRelations`	[CreateActivityRelationNoActivityBackrefInput!]	Accounts this task is linked to.
`contactRelations`	[CreateActivityRelationNoActivityBackrefInput!]	Contacts this task is linked to.
`leadRelations`	[CreateActivityRelationNoActivityBackrefInput!]	Leads this task is linked to.
`opportunityRelations`	[CreateActivityRelationNoActivityBackrefInput!]	Opportunities this task is linked to.
`projectRelations`	[CreateActivityRelationNoActivityBackrefInput!]	Projects this task is linked to, including the per-objective ordering.
`quoteRelations`	[CreateActivityRelationNoActivityBackrefInput!]	Quotes this task is linked to.
`customEntityRelations`	[CreateActivityRelationNoActivityBackrefInput!]	Custom entity records this task is linked to.
`exchangeEntityId`	String	External identifier of the record in the linked third-party service (e.g. Google, Microsoft 365, Exchange). Maintained by the sync engine.
`gapiEntityId`	String	External identifier of the record in the linked third-party service (e.g. Google, Microsoft 365, Exchange). Maintained by the sync engine.
`o365EntityId`	String	External identifier of the record in the linked third-party service (e.g. Google, Microsoft 365, Exchange). Maintained by the sync engine.
`taskRecurrence`	UpdateTaskRecurrenceNoTaskBackrefInput	Recurrence schedule generating periodic copies of this task, or empty when no recurrence is set up.
`documents`	[CreateCloudObjectRelationNoBackrefInput!]	Documents linked to this task.
`comments`	[CreateActivityCommentNoActivityBackrefInput!]	Comments authored on this task.
`tags`	[CreateTagRelationNoTaskBackrefInput!]	Tag labels applied to this task.
`callSid`	String	Identifier (SID) of a phone call made through Coevera calling, to attach that call to the task; null detaches the call. Write-only.

UpdateTaskRecurrenceNoTaskBackrefInput input 13 fields: applyRecurrence, modified, created, …

Id of a TaskRecurrence record and the field values to change, updated together with the record it belongs to.

Input field	Type	Description
`applyRecurrence`	Boolean	Default true. When set, then reccurence will apply when other conditions passed. With the value false (e.g. when skip button is used) then recurrence will not apply
`modified`	DateTime	Last modification time.
`created`	DateTime	Creation time.
`day`	DateDayEnum	Field whose values are strictly defined with an enumeration of values. The day of the month. This setting is applicable only for RecurrenceTypeEnum.MonthlyRelative and RecurrenceTypeEnum.YearlyRelative.
`dayOfWeek`	Int	Bit Flag field, with limited combination of integer values.
`endDate`	Date	Date information. The last date when no more other items should be created.
`month`	DateMonthEnum	Field whose values are strictly defined with an enumeration of values. The number of month this setting is applicable only for RecurrenceTypeEnum.YearlyAbsolute and RecurrenceTypeEnum.YearlyRelative.
`occurEvery`	Int	The number of units of a given recurrence type between occurrences according to RecurrenceTypeEnum.
`occurrencesCount`	Int	Whole natural number. The number of remaining occurrences. Each time a new one is created, it decreases. When item is set to 1, only last one can be created. If it is set to 0, recurrence is stopped. If -1, no limits are applied.
`startDate`	Date	Date information. The effective start date of recurrence, which means each next recurrence must be on or after this date.
`type`	RecurrenceTypeEnum	Recurrence cadence (e.g. Daily, Weekly, MonthlyAbsolute, MonthlyRelative, YearlyAbsolute, YearlyRelative, AfterNDays, AfterNWeeks, AfterNMonths, AfterNYears).
`week`	DateWeekEnum	Field whose values are strictly defined with an enumeration of values. The week of month. This setting is applicable only for RecurrenceTypeEnum.MonthlyAbsolute and RecurrenceTypeEnum.YearlyAbsolute.
`revision`	Int	Revision when entity was lastly changed.

UpdateTaskReminderNoTaskBackrefInput input 6 fields: modified, created, ownerId, …

Id of a TaskReminder record and the field values to change, updated together with the record it belongs to.

Input field	Type	Description
`modified`	DateTime	Last modification time.
`created`	DateTime	Creation time.
`ownerId`	ID	Id of the user who set the reminder.
`setDate`	DateTime	Timestamp when the reminder should fire.
`status`	ReminderStatusEnum	Current state of the reminder: Scheduled to fire at its set time, Snoozed until snoozeDate, or Dismissed.
`revision`	Int	Revision when entity was lastly changed.

BulkUpdateTaskPayload object result: BulkUpdateResults!

Result of the bulkUpdateTask mutation.

Field	Type	Description
`result`	BulkUpdateResults!	Ids of the created, updated and deleted records, and the items that failed.

ChangeOwnershipTaskPayload object result: TaskEntity, clientMutationId: String

Result of the changeOwnershipTask mutation.

Field	Type	Description
`result`	TaskEntity	The task with its new owner.
`clientMutationId`	String	Optional 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).

ConvertTaskPayload object task: TaskEntity!, clientMutationId: String

Result of the convertTask mutation.

Field	Type	Description
`task`	TaskEntity!	The created record.
`clientMutationId`	String	Optional 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).

CreateTaskPayload object task: TaskEntity, clientMutationId: String

Result of the createTask mutation.

Field	Type	Description
`task`	TaskEntity	The created record.
`clientMutationId`	String	Optional 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).

DeleteTaskPayload object task: TaskEntity, clientMutationId: String

Result of the deleteTask mutation.

Field	Type	Description
`task`	TaskEntity	The deleted record.
`clientMutationId`	String	Optional 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).

ManageSharingTaskPayload object result: TaskEntity, clientMutationId: String

Result of the manageSharingTask mutation.

Field	Type	Description
`result`	TaskEntity	The record with its updated sharing.
`clientMutationId`	String	Optional 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).

ReleaseOwnershipTaskPayload object result: TaskEntity, clientMutationId: String

Result of the releaseOwnershipTask mutation.

Field	Type	Description
`result`	TaskEntity	The released task.
`clientMutationId`	String	Optional 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).

RemoveReminderTaskPayload object result: TaskEntity, clientMutationId: String

Result of the removeReminderTask mutation.

Field	Type	Description
`result`	TaskEntity	The task with the dismissed reminder.
`clientMutationId`	String	Optional 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).

RestoreTaskPayload object result: TaskEntity, clientMutationId: String

Result of the restoreTask mutation.

Field	Type	Description
`result`	TaskEntity	The restored record.
`clientMutationId`	String	Optional 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).

SetReminderTaskPayload object result: TaskEntity, clientMutationId: String

Result of the setReminderTask mutation.

Field	Type	Description
`result`	TaskEntity	The task with the updated reminder.
`clientMutationId`	String	Optional 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).

SetTaskStatusPayload object result: TaskEntity, clientMutationId: String

Result of the setTaskStatus mutation.

Field	Type	Description
`result`	TaskEntity	The updated task.
`clientMutationId`	String	Optional 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).

UpdateTaskPayload object task: TaskEntity, clientMutationId: String

Result of the updateTask mutation.

Field	Type	Description
`task`	TaskEntity	The updated record.
`clientMutationId`	String	Optional 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).

PriorityEnum enum Low, Medium, High

Priority of a task.

Value	Description
`Low`	Low priority.
`Medium`	Medium priority.
`High`	High priority.

TaskAutoPrefill object entity: TaskEntity, fieldIds: [UUID!]!

New, unsaved task pre-filled by AI or from an email conversation, with the ids of the fields that were filled in.

Field	Type	Description
`entity`	TaskEntity	New task carrying the pre-filled values; it is not saved.
`fieldIds`	[UUID!]!	Ids of the fields that were filled in.

TaskStatusEnum enum NotStarted, InProgress, Waiting, Completed, Deferred

Status of a task.

Value	Description
`NotStarted`	Work on the task has not started.
`InProgress`	The task is being worked on.
`Waiting`	The task is waiting on someone or something else.
`Completed`	The task is done.
`Deferred`	The task has been postponed.