--- title: "Update Task by ID" method: PUT path: "/v3/tasks/{uniqueId}" tags: ["Tasks"] --- # Update Task by ID `PUT /v3/tasks/{uniqueId}` Allows the updating of an existing Task ## Path parameters - `uniqueId` '1' | '2' | '3', required — param ID of the Task that needs to be updated ## Query parameters - `fields` string[] - `createActivityLog` string ## Request body - Task - `id` integer - `caseId` integer, required - `caseXid` string, required - `xid` string - `name` string, required - `description` string - `configTask` JsonNode - `configPlaybook` string - `workflowPhase` integer - `workflowStep` integer - `dueDate` string, date-time - `required` boolean - `dependentOnId` integer - `status` string - `completedBy` string - `completedDate` string, date-time - `duration` integer - `assignee` Assignee - `id` integer - `type` string, required - `notes` ListEntityNote - `data` Note[] - `id` integer - `caseId` integer, required - `caseXid` string, required - `text` string, required - `summary` string - `author` string - `dateAdded` string, date-time - `lastModified` string, date-time - `edited` boolean - `taskId` integer - `taskXid` string - `artifactId` integer - `workflowEventId` integer - `count` integer - `countSuccess` integer - `countFailure` integer - `count_type` string - `next` string - `prev` string - `mode` string - `artifacts` ListEntityArtifact - `data` Artifact[] - `id` integer - `caseId` integer, required - `caseXid` string, required - `summary` string, required - `type` string, required - `fieldName` string - `artifactType` ArtifactType - `id` integer - `name` string - `description` string - `dataType` string - `intelType` string - `derivedLink` boolean - `intelType` string - `fileData` string - `source` string - `dateAdded` string, date-time - `analyticsType` string - `analyticsScore` integer - `analyticsPriority` string - `analyticsPriorityLevel` integer - `analyticsStatus` string - `taskId` integer - `taskXid` string - `notes` ListEntityNote - `data` Note[] - `id` integer - `caseId` integer, required - `caseXid` string, required - `text` string, required - `summary` string - `author` string - `dateAdded` string, date-time - `lastModified` string, date-time - `edited` boolean - `taskId` integer - `taskXid` string - `artifactId` integer - `workflowEventId` integer - `count` integer - `countSuccess` integer - `countFailure` integer - `count_type` string - `next` string - `prev` string - `mode` string - `links` ListEntityLink - `data` Link[] - `id` integer - `summary` string - `link` string - `count` integer - `countSuccess` integer - `countFailure` integer - `count_type` string - `next` string - `prev` string - `mode` string - `associatedGroups` ListEntityGroup - `data` Group[] - `id` integer - `dateAdded` string, date-time - `securityLabels` ListEntitySecurityLabel - `data` SecurityLabel[] - … - `count` integer - `countSuccess` integer - `countFailure` integer - `count_type` string - `next` string - `prev` string - `mode` string - `ownerId` integer - `ownerName` string - `webLink` string - `tags` ListEntityTag - `data` Tag[] - … - `count` integer - `countSuccess` integer - `countFailure` integer - `count_type` string - `next` string - `prev` string - `mode` string - `type` string, required - `xid` string - `name` string, required - `createdBy` User - `id` integer - `userName` string - `firstName` string - `lastName` string - `pseudonym` string - `owner` string - `password` string - `lastLogin` string, date-time - `lastPasswordChange` string, date-time - `uiTheme` string - `jobFunction` string - `jobRole` string - `termsAccepted` boolean - `termsAcceptedDate` string, date-time - `logoutIntervalMinutes` integer - `tqlTimeout` integer - `systemRole` string - `ownerRoles` object - `disabled` boolean - `locked` boolean - `passwordResetRequired` boolean - `twoFactorResetRequired` boolean - `customTqlTimeout` integer - `upVote` boolean - `upVoteCount` string - `downVoteCount` string - `generatedReport` boolean - `associatedGroups` ListEntityGroup — recursive - `associatedIndicators` ListEntityIndicator - `data` Indicator[] - … - `count` integer - `countSuccess` integer - `countFailure` integer - `count_type` string - `next` string - `prev` string - `mode` string - `associatedVictimAssets` ListEntityVictimAsset - `data` VictimAsset[] - … - `count` integer - `countSuccess` integer - `countFailure` integer - `count_type` string - `next` string - `prev` string - `mode` string - `externalDateAdded` string, date-time - `externalLastModified` string, date-time - `externalDateExpires` string, date-time - `associatedCases` ListEntityCase - `data` Case[] - … - `count` integer - `countSuccess` integer - `countFailure` integer - `count_type` string - `next` string - `prev` string - `mode` string - `associatedArtifacts` ListEntityArtifact — recursive - `attributes` ListEntityGroupAttributeData - `data` GroupAttributeData[] - … - `count` integer - `countSuccess` integer - `countFailure` integer - `count_type` string - `next` string - `prev` string - `mode` string - `reviews` ListEntityIntelligenceReview - `data` IntelligenceReview[] - … - `count` integer - `countSuccess` integer - `countFailure` integer - `count_type` string - `next` string - `prev` string - `mode` string - `handles` ListEntityAdversaryAsset - `data` AdversaryAsset[] - … - `count` integer - `countSuccess` integer - `countFailure` integer - `count_type` string - `next` string - `prev` string - `mode` string - `urls` ListEntityAdversaryAsset - `data` AdversaryAsset[] - … - `count` integer - `countSuccess` integer - `countFailure` integer - `count_type` string - `next` string - `prev` string - `mode` string - `fileName` string - `fileSize` integer - `status` string - `malware` boolean - `password` string - `documentType` string - `insights` AiInsights - `id` integer - `summary` string - `app` string - `aiProvider` string - `markdown` string - `bullets` string[] - `lastRetrievalDate` string, date-time - `generatedBy` User - … - `customAiContent` AiInsights - `id` integer - `summary` string - `app` string - `aiProvider` string - `markdown` string - `bullets` string[] - `lastRetrievalDate` string, date-time - `generatedBy` User - … - `documentDateAdded` string, date-time - `to` string - `from` string - `subject` string - `score` integer - `header` string - `body` string - `scoreIncludesBody` boolean - `emailDate` string, date-time - `scoreBreakdown` string - `eventType` string - `fileType` string - `fileText` string - `signatureDateAdded` string, date-time - `escalated` boolean - `reminded` boolean - `overdue` boolean - `dueDate` string, date-time - `reminderDate` string, date-time - `escalationDate` string, date-time - `lastModified` string, date-time - `assignments` ListEntityTaskAssignee - `data` TaskAssignee[] - … - `count` integer - `countSuccess` integer - `countFailure` integer - `count_type` string - `next` string - `prev` string - `mode` string - `legacyLink` string - `commonGroup` CommonGroup - `id` integer - `dateAdded` string, date-time - `securityLabels` ListEntitySecurityLabel - … - `ownerId` integer - `ownerName` string - `webLink` string - `tags` ListEntityTag - … - `type` string, required - `subtype` string, required - `name` string, required - `summary` string - `description` string - `source` string - `sourceURLs` string[] - `external` boolean - `lastModified` string, date-time - `linkedGroups` ListEntityGroup — recursive - `references` ListEntityCommonGroupSource - … - `cwes` ListEntityCommonGroupSource - … - `customAliases` ListEntityCommonGroupAlias - … - `mitreAliases` ListEntityCommonGroupAlias - … - `firstSeen` string, date-time - `lastSeen` string, date-time - `eventDate` string, date-time - `publishDate` string, date-time - `count` integer - `countSuccess` integer - `countFailure` integer - `count_type` string - `next` string - `prev` string - `mode` string - `associatedIndicators` ListEntityIndicator - `data` Indicator[] - `id` integer - `dateAdded` string, date-time - `securityLabels` ListEntitySecurityLabel - `data` SecurityLabel[] - … - `count` integer - `countSuccess` integer - `countFailure` integer - `count_type` string - `next` string - `prev` string - `mode` string - `ownerId` integer - `ownerName` string - `webLink` string - `tags` ListEntityTag - `data` Tag[] - … - `count` integer - `countSuccess` integer - `countFailure` integer - `count_type` string - `next` string - `prev` string - `mode` string - `type` string, required - `lastModified` string, date-time - `externalDateAdded` string, date-time - `externalLastModified` string, date-time - `externalDateExpires` string, date-time - `firstSeen` string, date-time - `lastSeen` string, date-time - `rating` number - `confidence` integer - `threatAssessRating` number, double - `threatAssessConfidence` number, double - `threatAssessScore` integer - `threatAssessScoreObserved` integer - `threatAssessScoreFalsePositive` integer - `calScore` integer - `source` string - `description` string - `summary` string - `observations` integer - `lastObserved` string, date-time - `falsePositives` integer - `lastFalsePositive` string, date-time - `falsePositiveReportedByUser` boolean - `falsePositiveFlag` boolean - `trackedUsers` object - `privateFlag` boolean - `active` boolean - `activeLocked` boolean - `value1` string - `value2` string - `value3` string - `flag1` boolean - `flag2` boolean - `flag3` boolean - `intValue1` integer - `intValue2` integer - `intValue3` integer - `investigationLinks` ListEntityInvestigationLink - `data` InvestigationLink[] - … - `count` integer - `countSuccess` integer - `countFailure` integer - `count_type` string - `next` string - `prev` string - `mode` string - `associatedGroups` ListEntityGroup - `data` Group[] - … - `count` integer - `countSuccess` integer - `countFailure` integer - `count_type` string - `next` string - `prev` string - `mode` string - `associatedIndicators` ListEntityIndicator — recursive - `fileActions` ListEntityFileAction - `data` FileAction[] - … - `count` integer - `countSuccess` integer - `countFailure` integer - `count_type` string - `next` string - `prev` string - `mode` string - `fileOccurrences` ListEntityFileOccurrence - `data` FileOccurrence[] - … - `count` integer - `countSuccess` integer - `countFailure` integer - `count_type` string - `next` string - `prev` string - `mode` string - `attributes` ListEntityIndicatorAttributeData - `data` IndicatorAttributeData[] - … - `count` integer - `countSuccess` integer - `countFailure` integer - `count_type` string - `next` string - `prev` string - `mode` string - `associatedCases` ListEntityCase - `data` Case[] - … - `count` integer - `countSuccess` integer - `countFailure` integer - `count_type` string - `next` string - `prev` string - `mode` string - `associatedArtifacts` ListEntityArtifact — recursive - `address` string - `md5` string - `sha1` string - `sha256` string - `size` integer - `mode` string - `ip` string - `hostName` string - `dnsActive` boolean - `whoisActive` boolean - `whois` ListEntityWhoIs - `data` WhoIs[] - … - `count` integer - `countSuccess` integer - `countFailure` integer - `count_type` string - `next` string - `prev` string - `mode` string - `geoLocation` GeoLocation - `id` integer - `country` string - `countryCode` string - `state` string - `timezone` string - `city` string - `asn` integer - `registeringOrg` string - `lat` number, double - `lon` number, double - `dnsResolution` ListEntityDNSResolution - `data` DNSResolution[] - … - `count` integer - `countSuccess` integer - `countFailure` integer - `count_type` string - `next` string - `prev` string - `mode` string - `text` string - `legacyLink` string - `enrichment` ListEntityAbstractEnrichment - `data` AbstractEnrichment[] - … - `count` integer - `countSuccess` integer - `countFailure` integer - `count_type` string - `next` string - `prev` string - `mode` string - `fileOccurrence` ListEntityFileOccurrence - `data` FileOccurrence[] - … - `count` integer - `countSuccess` integer - `countFailure` integer - `count_type` string - `next` string - `prev` string - `mode` string - `count` integer - `countSuccess` integer - `countFailure` integer - `count_type` string - `next` string - `prev` string - `mode` string - `derivedLink` boolean - `hashCode` string - `count` integer - `countSuccess` integer - `countFailure` integer - `count_type` string - `next` string - `prev` string - `mode` string - `durationType` string - `owner` string ## Response `200` The updated Task - Task - `id` integer - `caseId` integer, required - `caseXid` string, required - `xid` string - `name` string, required - `description` string - `configTask` JsonNode - `configPlaybook` string - `workflowPhase` integer - `workflowStep` integer - `dueDate` string, date-time - `required` boolean - `dependentOnId` integer - `status` string - `completedBy` string - `completedDate` string, date-time - `duration` integer - `assignee` Assignee - `id` integer - `type` string, required - `notes` ListEntityNote - `data` Note[] - `id` integer - `caseId` integer, required - `caseXid` string, required - `text` string, required - `summary` string - `author` string - `dateAdded` string, date-time - `lastModified` string, date-time - `edited` boolean - `taskId` integer - `taskXid` string - `artifactId` integer - `workflowEventId` integer - `count` integer - `countSuccess` integer - `countFailure` integer - `count_type` string - `next` string - `prev` string - `mode` string - `artifacts` ListEntityArtifact - `data` Artifact[] - `id` integer - `caseId` integer, required - `caseXid` string, required - `summary` string, required - `type` string, required - `fieldName` string - `artifactType` ArtifactType - `id` integer - `name` string - `description` string - `dataType` string - `intelType` string - `derivedLink` boolean - `intelType` string - `fileData` string - `source` string - `dateAdded` string, date-time - `analyticsType` string - `analyticsScore` integer - `analyticsPriority` string - `analyticsPriorityLevel` integer - `analyticsStatus` string - `taskId` integer - `taskXid` string - `notes` ListEntityNote - `data` Note[] - `id` integer - `caseId` integer, required - `caseXid` string, required - `text` string, required - `summary` string - `author` string - `dateAdded` string, date-time - `lastModified` string, date-time - `edited` boolean - `taskId` integer - `taskXid` string - `artifactId` integer - `workflowEventId` integer - `count` integer - `countSuccess` integer - `countFailure` integer - `count_type` string - `next` string - `prev` string - `mode` string - `links` ListEntityLink - `data` Link[] - `id` integer - `summary` string - `link` string - `count` integer - `countSuccess` integer - `countFailure` integer - `count_type` string - `next` string - `prev` string - `mode` string - `associatedGroups` ListEntityGroup - `data` Group[] - `id` integer - `dateAdded` string, date-time - `securityLabels` ListEntitySecurityLabel - `data` SecurityLabel[] - … - `count` integer - `countSuccess` integer - `countFailure` integer - `count_type` string - `next` string - `prev` string - `mode` string - `ownerId` integer - `ownerName` string - `webLink` string - `tags` ListEntityTag - `data` Tag[] - … - `count` integer - `countSuccess` integer - `countFailure` integer - `count_type` string - `next` string - `prev` string - `mode` string - `type` string, required - `xid` string - `name` string, required - `createdBy` User - `id` integer - `userName` string - `firstName` string - `lastName` string - `pseudonym` string - `owner` string - `password` string - `lastLogin` string, date-time - `lastPasswordChange` string, date-time - `uiTheme` string - `jobFunction` string - `jobRole` string - `termsAccepted` boolean - `termsAcceptedDate` string, date-time - `logoutIntervalMinutes` integer - `tqlTimeout` integer - `systemRole` string - `ownerRoles` object - `disabled` boolean - `locked` boolean - `passwordResetRequired` boolean - `twoFactorResetRequired` boolean - `customTqlTimeout` integer - `upVote` boolean - `upVoteCount` string - `downVoteCount` string - `generatedReport` boolean - `associatedGroups` ListEntityGroup — recursive - `associatedIndicators` ListEntityIndicator - `data` Indicator[] - … - `count` integer - `countSuccess` integer - `countFailure` integer - `count_type` string - `next` string - `prev` string - `mode` string - `associatedVictimAssets` ListEntityVictimAsset - `data` VictimAsset[] - … - `count` integer - `countSuccess` integer - `countFailure` integer - `count_type` string - `next` string - `prev` string - `mode` string - `externalDateAdded` string, date-time - `externalLastModified` string, date-time - `externalDateExpires` string, date-time - `associatedCases` ListEntityCase - `data` Case[] - … - `count` integer - `countSuccess` integer - `countFailure` integer - `count_type` string - `next` string - `prev` string - `mode` string - `associatedArtifacts` ListEntityArtifact — recursive - `attributes` ListEntityGroupAttributeData - `data` GroupAttributeData[] - … - `count` integer - `countSuccess` integer - `countFailure` integer - `count_type` string - `next` string - `prev` string - `mode` string - `reviews` ListEntityIntelligenceReview - `data` IntelligenceReview[] - … - `count` integer - `countSuccess` integer - `countFailure` integer - `count_type` string - `next` string - `prev` string - `mode` string - `handles` ListEntityAdversaryAsset - `data` AdversaryAsset[] - … - `count` integer - `countSuccess` integer - `countFailure` integer - `count_type` string - `next` string - `prev` string - `mode` string - `urls` ListEntityAdversaryAsset - `data` AdversaryAsset[] - … - `count` integer - `countSuccess` integer - `countFailure` integer - `count_type` string - `next` string - `prev` string - `mode` string - `fileName` string - `fileSize` integer - `status` string - `malware` boolean - `password` string - `documentType` string - `insights` AiInsights - `id` integer - `summary` string - `app` string - `aiProvider` string - `markdown` string - `bullets` string[] - `lastRetrievalDate` string, date-time - `generatedBy` User - … - `customAiContent` AiInsights - `id` integer - `summary` string - `app` string - `aiProvider` string - `markdown` string - `bullets` string[] - `lastRetrievalDate` string, date-time - `generatedBy` User - … - `documentDateAdded` string, date-time - `to` string - `from` string - `subject` string - `score` integer - `header` string - `body` string - `scoreIncludesBody` boolean - `emailDate` string, date-time - `scoreBreakdown` string - `eventType` string - `fileType` string - `fileText` string - `signatureDateAdded` string, date-time - `escalated` boolean - `reminded` boolean - `overdue` boolean - `dueDate` string, date-time - `reminderDate` string, date-time - `escalationDate` string, date-time - `lastModified` string, date-time - `assignments` ListEntityTaskAssignee - `data` TaskAssignee[] - … - `count` integer - `countSuccess` integer - `countFailure` integer - `count_type` string - `next` string - `prev` string - `mode` string - `legacyLink` string - `commonGroup` CommonGroup - `id` integer - `dateAdded` string, date-time - `securityLabels` ListEntitySecurityLabel - … - `ownerId` integer - `ownerName` string - `webLink` string - `tags` ListEntityTag - … - `type` string, required - `subtype` string, required - `name` string, required - `summary` string - `description` string - `source` string - `sourceURLs` string[] - `external` boolean - `lastModified` string, date-time - `linkedGroups` ListEntityGroup — recursive - `references` ListEntityCommonGroupSource - … - `cwes` ListEntityCommonGroupSource - … - `customAliases` ListEntityCommonGroupAlias - … - `mitreAliases` ListEntityCommonGroupAlias - … - `firstSeen` string, date-time - `lastSeen` string, date-time - `eventDate` string, date-time - `publishDate` string, date-time - `count` integer - `countSuccess` integer - `countFailure` integer - `count_type` string - `next` string - `prev` string - `mode` string - `associatedIndicators` ListEntityIndicator - `data` Indicator[] - `id` integer - `dateAdded` string, date-time - `securityLabels` ListEntitySecurityLabel - `data` SecurityLabel[] - … - `count` integer - `countSuccess` integer - `countFailure` integer - `count_type` string - `next` string - `prev` string - `mode` string - `ownerId` integer - `ownerName` string - `webLink` string - `tags` ListEntityTag - `data` Tag[] - … - `count` integer - `countSuccess` integer - `countFailure` integer - `count_type` string - `next` string - `prev` string - `mode` string - `type` string, required - `lastModified` string, date-time - `externalDateAdded` string, date-time - `externalLastModified` string, date-time - `externalDateExpires` string, date-time - `firstSeen` string, date-time - `lastSeen` string, date-time - `rating` number - `confidence` integer - `threatAssessRating` number, double - `threatAssessConfidence` number, double - `threatAssessScore` integer - `threatAssessScoreObserved` integer - `threatAssessScoreFalsePositive` integer - `calScore` integer - `source` string - `description` string - `summary` string - `observations` integer - `lastObserved` string, date-time - `falsePositives` integer - `lastFalsePositive` string, date-time - `falsePositiveReportedByUser` boolean - `falsePositiveFlag` boolean - `trackedUsers` object - `privateFlag` boolean - `active` boolean - `activeLocked` boolean - `value1` string - `value2` string - `value3` string - `flag1` boolean - `flag2` boolean - `flag3` boolean - `intValue1` integer - `intValue2` integer - `intValue3` integer - `investigationLinks` ListEntityInvestigationLink - `data` InvestigationLink[] - … - `count` integer - `countSuccess` integer - `countFailure` integer - `count_type` string - `next` string - `prev` string - `mode` string - `associatedGroups` ListEntityGroup - `data` Group[] - … - `count` integer - `countSuccess` integer - `countFailure` integer - `count_type` string - `next` string - `prev` string - `mode` string - `associatedIndicators` ListEntityIndicator — recursive - `fileActions` ListEntityFileAction - `data` FileAction[] - … - `count` integer - `countSuccess` integer - `countFailure` integer - `count_type` string - `next` string - `prev` string - `mode` string - `fileOccurrences` ListEntityFileOccurrence - `data` FileOccurrence[] - … - `count` integer - `countSuccess` integer - `countFailure` integer - `count_type` string - `next` string - `prev` string - `mode` string - `attributes` ListEntityIndicatorAttributeData - `data` IndicatorAttributeData[] - … - `count` integer - `countSuccess` integer - `countFailure` integer - `count_type` string - `next` string - `prev` string - `mode` string - `associatedCases` ListEntityCase - `data` Case[] - … - `count` integer - `countSuccess` integer - `countFailure` integer - `count_type` string - `next` string - `prev` string - `mode` string - `associatedArtifacts` ListEntityArtifact — recursive - `address` string - `md5` string - `sha1` string - `sha256` string - `size` integer - `mode` string - `ip` string - `hostName` string - `dnsActive` boolean - `whoisActive` boolean - `whois` ListEntityWhoIs - `data` WhoIs[] - … - `count` integer - `countSuccess` integer - `countFailure` integer - `count_type` string - `next` string - `prev` string - `mode` string - `geoLocation` GeoLocation - `id` integer - `country` string - `countryCode` string - `state` string - `timezone` string - `city` string - `asn` integer - `registeringOrg` string - `lat` number, double - `lon` number, double - `dnsResolution` ListEntityDNSResolution - `data` DNSResolution[] - … - `count` integer - `countSuccess` integer - `countFailure` integer - `count_type` string - `next` string - `prev` string - `mode` string - `text` string - `legacyLink` string - `enrichment` ListEntityAbstractEnrichment - `data` AbstractEnrichment[] - … - `count` integer - `countSuccess` integer - `countFailure` integer - `count_type` string - `next` string - `prev` string - `mode` string - `fileOccurrence` ListEntityFileOccurrence - `data` FileOccurrence[] - … - `count` integer - `countSuccess` integer - `countFailure` integer - `count_type` string - `next` string - `prev` string - `mode` string - `count` integer - `countSuccess` integer - `countFailure` integer - `count_type` string - `next` string - `prev` string - `mode` string - `derivedLink` boolean - `hashCode` string - `count` integer - `countSuccess` integer - `countFailure` integer - `count_type` string - `next` string - `prev` string - `mode` string - `durationType` string - `owner` string --- [API](https://skmtc.net/threatconnect/apis/threatconnect-api.md) · [All operations](https://skmtc.net/threatconnect/apis/threatconnect-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/threatconnect/threatconnect-api/versions/730b8a350ae7/schema)