---
title: entities.task
description: Read task records with the task repository, and change them with the task mutations. Same records as the REST Tasks entity.
canonical: https://developers.coevera.com/reference/graphql/task/
section: graphql
verification: schema
generatedFrom: schema f155746 (2026-10-20)
publisher: Coevera
---

# entities.task

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

REST: [Tasks](https://developers.coevera.com/reference/rest/tasks.md).

## Queries

- `getById(entityId: ID!): TaskEntity` Returns the record with the given id, or null when there is none. Deleted records are returned as well.
- `getByIds(entityIds: [ID!]!): [TaskEntity!]!` Returns the records with the given ids; ids without a record are left out. Deleted records are returned as well.
- `getAll(limit: Int, offset: Int, filter: TaskFilterInput, orderBy: [TaskOrderByInput!], includeDeleted: Boolean): [TaskEntity!]!` Returns the records that match the filter, paged with limit and offset.
- `getByCriteria(filter: TaskFilterInput, orderBy: [TaskOrderByInput!], includeDeleted: Boolean, before: String, after: String, first: Int, last: Int): TaskEntityConnection` Returns the records that match the filter as a cursor-paginated connection.
- `getChangedFieldsSinceRevision(id: UUID!, revision: Int!): [UUID!]!` Returns the ids of the fields of a record that changed after the given revision. Returns an empty list for entities without change tracking.
- `getBySession(includedIds: [UUID!]!, excludedIds: [UUID!]!, sessionId: String!, before: String, after: String, first: Int, last: Int): TaskEntityConnection` 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.
- `getByIdFormatted(id: UUID!, fieldIds: [UUID!]): JSONString` Returns the values of a record's fields formatted for display, keyed by field id.
- `autoPrefill(mappingId: UUID!, entityId: UUID!, targetEntityTypeId: UUID): TaskEntity!` 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.
- `aiAutoPrefill(actionId: String!): TaskAutoPrefill!` Returns an unsaved record pre-filled with the values proposed by an AI record suggestion, together with the fields the suggestion filled in.
- `autoPrefillFromEmail(emailId: UUID!, mailboxId: UUID): TaskAutoPrefill!` 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 …

## Mutations

- `changeOwnershipTask(input: ChangeOwnershipTaskInput!): ChangeOwnershipTaskPayload` Change owner. GraphQL only.
- `releaseOwnershipTask(input: ReleaseOwnershipTaskInput!): ReleaseOwnershipTaskPayload` Release ownership. GraphQL only.
- `manageSharingTask(input: ManageSharingTaskInput!): ManageSharingTaskPayload` Change who it is shared with. GraphQL only.
- `restoreTask(input: RestoreTaskInput!): RestoreTaskPayload` Restore a deleted record.
- `setReminderTask(input: SetReminderTaskInput!): SetReminderTaskPayload` Set a reminder. GraphQL only.
- `removeReminderTask(input: RemoveReminderTaskInput!): RemoveReminderTaskPayload` Remove the reminder. GraphQL only.
- `setTaskStatus(input: SetTaskStatusInput!): SetTaskStatusPayload` Changes the status of the task, for example to InProgress or Completed. GraphQL only.
- `createTask(input: CreateTaskInput!, validationLevel: [ValidationLevel!]): CreateTaskPayload` Create one record.
- `updateTask(input: UpdateTaskInput!, validationLevel: [ValidationLevel!], sessionIdToUpdate: String): UpdateTaskPayload` Update fields.
- `bulkUpdateTask(input: [CreateOrUpdateTaskInput!]!, deleteInput: [DeleteTaskInput!], validationLevel: [ValidationLevel!], rollbackMethod: RollbackMethod, match: MatchingInput): BulkUpdateTaskPayload` Create or update many; per-item results.
- `deleteTask(input: DeleteTaskInput!): DeleteTaskPayload` Soft-delete.
- `convertTask(input: CreateTaskInput!, sourceEntity: EntityNameEnum!, sourceEntityId: UUID!, operation: RecordConversionOperationEnum!, options: RecordConversionOptions!, sourceEntityApiName: String, validationLevel: [ValidationLevel!]): ConvertTaskPayload` Create from another record. GraphQL only.

## Types

### TaskEntity (object)

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

- `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)

Paginated list of Task records.

- `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)

A Relay edge containing a `TaskEntity` and its cursor.

- `node: TaskEntity` The item at the end of the edge
- `cursor: String!` A cursor for use in pagination

### PriorityEnumFilterInput (input)

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

- `eq: [PriorityEnum!]` Matches any of the listed values.
- `NOT: PriorityEnumFilterInput` Matches values that do not meet this condition.

### TaskFilterInput (input)

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

- `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)

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

- `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)

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

- `eq: [TaskStatusEnum!]` Matches any of the listed values.
- `NOT: TaskStatusEnumFilterInput` Matches values that do not meet this condition.

### ChangeOwnershipTaskInput (input)

Parameters of the changeOwnershipTask mutation.

- `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)

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

- `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)

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

- `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)

Field values of a new Task 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).
- `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)

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

- `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)

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

- `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)

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

- `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)

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

- `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)

Id of the Task record to delete.

- `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)

Parameters of the manageSharingTask mutation.

- `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)

Parameters of the releaseOwnershipTask mutation.

- `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)

Parameters of the removeReminderTask mutation.

- `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)

Parameters of the restoreTask mutation.

- `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)

Parameters of the setReminderTask mutation.

- `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)

Parameters of the setTaskStatus mutation.

- `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)

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

- `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)

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

- `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)

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

- `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)

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

- `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)

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

- `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 of the bulkUpdateTask mutation.

- `result: BulkUpdateResults!` Ids of the created, updated and deleted records, and the items that failed.

### ChangeOwnershipTaskPayload (object)

Result of the changeOwnershipTask mutation.

- `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)

Result of the convertTask mutation.

- `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)

Result of the createTask mutation.

- `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)

Result of the deleteTask mutation.

- `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 of the manageSharingTask mutation.

- `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 of the releaseOwnershipTask mutation.

- `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 of the removeReminderTask mutation.

- `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 of the restoreTask mutation.

- `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 of the setReminderTask mutation.

- `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 of the setTaskStatus mutation.

- `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)

Result of the updateTask mutation.

- `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)

Priority of a task.

- `Low` Low priority.
- `Medium` Medium priority.
- `High` High priority.

### TaskAutoPrefill (object)

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

- `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)

Status of a task.

- `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.

Types several repositories share, such as `PageInfo` and the filter fields, are in the [types index](https://developers.coevera.com/reference/graphql/types.md). The [SDL](https://developers.coevera.com/graphql/schema.graphql) has the whole schema in one file.

## Example

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

```bash
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 } } } } } }"}'
```

## Examples of each operation

Built from the schema and checked against it; replace the placeholders, such as `<task id>`, with values from your space.

### getById

```graphql
query TaskGetById {
  entities {
    task {
      getById(entityId: "<task id>") {
        id
        formattedName
        subject
        modified
      }
    }
  }
}
```

### getByIds

```graphql
query TaskGetByIds {
  entities {
    task {
      getByIds(entityIds: ["<task id>"]) {
        id
        formattedName
        subject
        modified
      }
    }
  }
}
```

### getAll

```graphql
query TaskGetAll {
  entities {
    task {
      getAll(limit: 10) {
        id
        formattedName
        subject
        modified
      }
    }
  }
}
```

### getByCriteria

```graphql
query TaskGetByCriteria {
  entities {
    task {
      getByCriteria(first: 10) {
        totalCount
        edges {
          node {
            id
            formattedName
            subject
            modified
          }
        }
        pageInfo {
          hasNextPage
          endCursor
        }
      }
    }
  }
}
```

### getChangedFieldsSinceRevision

```graphql
query TaskGetChangedFieldsSinceRevision {
  entities {
    task {
      getChangedFieldsSinceRevision(id: "<task id>", revision: 10)
    }
  }
}
```

### getBySession

```graphql
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
        }
      }
    }
  }
}
```

### getByIdFormatted

```graphql
query TaskGetByIdFormatted {
  entities {
    task {
      getByIdFormatted(id: "<task id>")
    }
  }
}
```

### autoPrefill

```graphql
query TaskAutoPrefill {
  entities {
    task {
      autoPrefill(mappingId: "<mapping id>", entityId: "<task id>") {
        id
        formattedName
        subject
        modified
      }
    }
  }
}
```

### aiAutoPrefill

```graphql
query TaskAiAutoPrefill {
  entities {
    task {
      aiAutoPrefill(actionId: "<action id>") {
        entity {
          id
          formattedName
          subject
          modified
        }
        fieldIds
      }
    }
  }
}
```

### autoPrefillFromEmail

```graphql
query TaskAutoPrefillFromEmail {
  entities {
    task {
      autoPrefillFromEmail(emailId: "<email id>") {
        entity {
          id
          formattedName
          subject
          modified
        }
        fieldIds
      }
    }
  }
}
```

### changeOwnershipTask

```graphql
mutation ChangeOwnershipTask {
  changeOwnershipTask(
    input: {ownerId: "<owner id>", unitId: "<unit id>", keepOwnerAsEditor: false, id: "<task id>"}
  ) {
    result {
      id
      formattedName
      subject
      modified
    }
  }
}
```

### releaseOwnershipTask

```graphql
mutation ReleaseOwnershipTask {
  releaseOwnershipTask(input: {id: "<task id>"}) {
    result {
      id
      formattedName
      subject
      modified
    }
  }
}
```

### manageSharingTask

```graphql
mutation ManageSharingTask {
  manageSharingTask(input: {shareMode: Standard, id: "<task id>"}) {
    result {
      id
      formattedName
      subject
      modified
    }
  }
}
```

### restoreTask

```graphql
mutation RestoreTask {
  restoreTask(input: {id: "<task id>"}) {
    result {
      id
      formattedName
      subject
      modified
    }
  }
}
```

### setReminderTask

```graphql
mutation SetReminderTask {
  setReminderTask(input: {id: "<task id>"}) {
    result {
      id
      formattedName
      subject
      modified
    }
  }
}
```

### removeReminderTask

```graphql
mutation RemoveReminderTask {
  removeReminderTask(input: {id: "<task id>"}) {
    result {
      id
      formattedName
      subject
      modified
    }
  }
}
```

### setTaskStatus

```graphql
mutation SetTaskStatus {
  setTaskStatus(input: {newStatus: NotStarted, id: "<task id>"}) {
    result {
      id
      formattedName
      subject
      modified
    }
  }
}
```

### createTask

```graphql
mutation CreateTask {
  createTask(input: {subject: "Call Northwind Analytics"}) {
    task {
      id
      formattedName
      subject
      modified
    }
  }
}
```

### updateTask

```graphql
mutation UpdateTask {
  updateTask(input: {id: "<task id>"}) {
    task {
      id
      formattedName
      subject
      modified
    }
  }
}
```

### bulkUpdateTask

```graphql
mutation BulkUpdateTask {
  bulkUpdateTask(input: [{id: "<task id>"}]) {
    result {
      created {
        id
      }
      errors {
        index
        code
        message
        entityId
      }
      updated
      deleted
      errorsOnDelete {
        index
        code
        message
        entityId
      }
    }
  }
}
```

### deleteTask

```graphql
mutation DeleteTask {
  deleteTask(input: {id: "<task id>"}) {
    task {
      id
      formattedName
      subject
      modified
    }
  }
}
```

### convertTask

```graphql
mutation ConvertTask {
  convertTask(
    input: {subject: "Call Northwind Analytics"}
    sourceEntity: AiAgent
    sourceEntityId: "<source entity id>"
    operation: Nothing
    options: {}
  ) {
    task {
      id
      formattedName
      subject
      modified
    }
  }
}
```
