> ## Documentation Index
> Fetch the complete documentation index at: https://developers.wrike.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Create Comment (Task)
Create comment in task.
Scopes: Default, wsReadWrite
# OpenAPI definition
```json
{
"openapi": "3.0.1",
"info": {
"title": "Wrike API",
"version": "4.0"
},
"servers": [
{
"url": "https://www.wrike.com/api/v4"
},
{
"url": "https://app-eu.wrike.com/api/v4"
},
{
"url": "https://app-us2.wrike.com/api/v4"
}
],
"paths": {
"/tasks/{taskId}/comments": {
"post": {
"tags": [
"Comments"
],
"summary": "Create Comment (Task)",
"description": "Create comment in task.\n\nScopes: Default, wsReadWrite",
"operationId": "POST:/tasks/single/comments",
"parameters": [
{
"name": "taskId",
"in": "path",
"required": true,
"schema": {
"$ref": "#/components/schemas/TaskId"
}
},
{
"name": "text",
"in": "query",
"description": "Comment text, can not be empty. Supported HTML tags can be found in Special syntax",
"required": true,
"schema": {
"type": "string",
"description": "Comment text, can not be empty. Supported HTML tags can be found in Special syntax"
}
},
{
"name": "plainText",
"in": "query",
"description": "Treat comment text as plain text, HTML otherwise",
"required": false,
"schema": {
"type": "boolean",
"description": "Treat comment text as plain text, HTML otherwise",
"default": "false"
}
}
],
"responses": {
"2XX": {
"description": "success response",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Comment"
}
},
"kind": {
"$ref": "#/components/schemas/ResponseKind"
}
}
}
}
}
},
"4XX": {
"description": "client-side error response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"5XX": {
"description": "server-side error response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
}
},
"security": [
{
"HTTP": []
}
]
}
}
},
"components": {
"schemas": {
"ResponseKind": {
"type": "string",
"enum": [
"accounts",
"users",
"contacts",
"assets",
"eDiscoveryReport",
"folders",
"folderTree",
"tasks",
"taskIds",
"timelogs",
"timelogCategories",
"timelogLockPeriods",
"timetrackerTimers",
"comments",
"attachments",
"url",
"version",
"dataExport",
"dataExportSchema",
"auditLog",
"accessRoles",
"stream",
"changes",
"posts",
"mailSettings",
"integrationInfo",
"gmailIntegrationSettings",
"workTypesForIntegrations",
"ids",
"backups",
"domains",
"dependencies",
"workflows",
"workschedules",
"workscheduleExclusions",
"workscheduleUserExclusions",
"customfields",
"customfieldIds",
"customstatuses",
"invitations",
"notifications",
"jobroles",
"placeholders",
"groups",
"session",
"dashboards",
"widgets",
"taskCreationSettings",
"colors",
"experiments",
"topics",
"topicComments",
"webhooks",
"reviews",
"boards",
"textSearch",
"chatChannels",
"chatMessages",
"forms",
"requestForms",
"request",
"report",
"platformWidgets",
"platformWidgetInstances",
"spaces",
"pdf",
"customerSatisfaction",
"asyncJob",
"approvals",
"highlights",
"highlightsList",
"highlightsSettings",
"highlightsCard",
"timesheet",
"timesheetRow",
"timesheetSubmissionRule",
"mobileFeatures",
"mobileSettings",
"folderBlueprintTree",
"taskBlueprintTree",
"feedback",
"timeline_snapshot",
"contactIds",
"bookings",
"integrateThreshold",
"hourlyRatesProvision",
"hourlyRates",
"projectTeamMembers",
"contactsHistory",
"tasksHistory",
"foldersHistory",
"activityDigest",
"workItemTemplates",
"workTemplates",
"workItemMetadata",
"workItem",
"customItemTypes",
"verificationCode",
"views",
"listView",
"tableView",
"userTypes",
"reactions",
"externalRequesters",
"workscheduleCapacityOverrides",
"userCapacityOverrides",
"userCapacityExclusions",
"rollups",
"requestFormPrefill",
"cascadingFieldSettings"
]
},
"ErrorType": {
"type": "string",
"enum": [
"invalid_request",
"invalid_parameter",
"parameter_required",
"not_authorized",
"access_forbidden",
"not_allowed",
"resource_not_found",
"method_not_found",
"too_many_requests",
"rate_limit_exceeded",
"server_error"
]
},
"ErrorResponse": {
"type": "object",
"properties": {
"errorDescription": {
"type": "string"
},
"error": {
"$ref": "#/components/schemas/ErrorType"
}
}
},
"ExternalRequesterId": {
"pattern": "^([A-Z0-9]){16}$",
"type": "string"
},
"CommentType": {
"type": "string",
"description": "* `Email`\n* `Regular`",
"enum": [
"Email",
"Regular"
]
},
"ExternalRequester": {
"required": [
"id",
"firstName",
"email"
],
"type": "object",
"properties": {
"firstName": {
"type": "string",
"description": "The first name of the external requester"
},
"lastName": {
"type": "string",
"description": "The last name of the external requester"
},
"id": {
"$ref": "#/components/schemas/ExternalRequesterId"
},
"email": {
"type": "string",
"description": "The email address of the external requester"
}
}
},
"TaskId": {
"pattern": "^([a-zA-Z0-9-_:\\.=]){1,256}$",
"type": "string"
},
"Comment": {
"type": "object",
"properties": {
"externalRequester": {
"$ref": "#/components/schemas/ExternalRequester"
},
"createdDate": {
"type": "string",
"description": "Created date
Format: yyyy-MM-dd'T'HH:mm:ss'Z'"
},
"id": {
"$ref": "#/components/schemas/CommentId"
},
"text": {
"type": "string",
"description": "Comment text"
},
"updatedDate": {
"type": "string",
"description": "Deprecated because this field gets created date instead of updated date. Please use the createdDate field instead.
Format: yyyy-MM-dd'T'HH:mm:ss'Z'"
},
"authorId": {
"$ref": "#/components/schemas/UserId"
},
"type": {
"$ref": "#/components/schemas/CommentType"
},
"emailSubject": {
"type": "string",
"description": "The subject in case of email comment"
},
"taskId": {
"type": "string",
"description": "ID of related task. Only one of taskId/folderId fields is present"
},
"folderId": {
"type": "string",
"description": "ID of related folder. Only one of taskId/folderId fields is present"
},
"direction": {
"type": "string",
"description": "The direction (Outgoing/Incoming) in case of email comment"
}
}
},
"CommentId": {
"pattern": "^([A-Z0-9]){16}$",
"type": "string"
},
"UserId": {
"pattern": "^([A-Z0-9]){8}$",
"type": "string"
}
},
"securitySchemes": {
"HTTP": {
"type": "http",
"description": "Use OAuth 2.0 access token or permanent access token for authorization.",
"scheme": "bearer",
"bearerFormat": "JWT"
}
}
}
}
```