# Tasks

Tasks are used on workspaces and can be connected to people, organizations, and conversations.

Good to know:

* A task must always contain a title
* A task must be part of a workspace
* The type (task or deal) is determined by the workspace

## Creates a Task resource.

> Creates a Task resource.

```json
{"openapi":"3.1.0","info":{"title":"RogerRoger API","version":"1.0.0"},"tags":[{"name":"Task","description":"Resource 'Task' operations."}],"servers":[{"url":"https://api.rogerroger.io","description":"API"}],"security":[{"BearerAuth":[]},{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","description":"Your API key, available from the dashboard","name":"X-API-KEY","in":"header"}},"schemas":{"Task.jsonld":{"allOf":[{"$ref":"#/components/schemas/HydraItemBaseSchema"},{"type":"object","properties":{"id":{"type":["string","null"]},"position":{"type":["integer","null"]},"totalComments":{"type":["integer","null"]},"title":{"type":["string","null"]},"description":{"type":["string","null"]},"isFlagged":{"type":["boolean","null"]},"isSubTask":{"type":["boolean","null"]},"indexNumber":{"type":["integer","null"]},"createdAt":{"type":["string","null"],"format":"date-time"},"updatedAt":{"type":["string","null"],"format":"date-time"},"completedAt":{"type":["string","null"],"format":"date-time"},"archivedAt":{"type":["string","null"],"format":"date-time"},"dueDate":{"type":["string","null"],"format":"date-time"},"workspace":{"type":["string","null"],"format":"iri-reference"},"status":{"type":["string","null"],"format":"iri-reference"},"author":{"type":["string","null"],"format":"iri-reference"},"parent":{"type":["string","null"],"format":"iri-reference"},"tags":{"type":"array","items":{"type":"string","format":"iri-reference"}},"assignees":{"type":"array","items":{"type":"string","format":"iri-reference"}},"observers":{"type":"array","items":{"type":"string","format":"iri-reference"}},"subTasks":{"anyOf":[{"type":"array","items":{"type":"string","format":"iri-reference"}},{"type":"array","items":{"type":"string","format":"iri-reference"}}]},"completedSubtasks":{"type":["integer","null"]},"totalSubtasks":{"type":["integer","null"]},"isTemplate":{"type":["boolean","null"]},"storyPointEstimation":{"type":["integer","null"]},"timeEstimation":{"type":["integer","null"]},"dealSizeEstimation":{"type":["integer","null"]},"messageProvider":{"type":["string","null"]},"scheduledOn":{"type":["string","null"]},"previouslyScheduledOn":{"type":["string","null"]},"plannedWeek":{"type":["string","null"]},"plannedMonth":{"type":["string","null"]},"snoozeUntil":{"type":["string","null"],"format":"date-time"},"isRecurring":{"type":["boolean","null"]},"workspaceType":{"type":["string","null"]},"files":{"type":"array","items":{"$ref":"#/components/schemas/MediaObject.jsonld"}},"messages":{"type":"array","items":{"type":"null"}},"conversationItems":{"type":"array","items":{"type":"string","format":"iri-reference"}},"people":{"type":"array","items":{"type":"string","format":"iri-reference"}},"organizations":{"type":"array","items":{"type":"string","format":"iri-reference"}},"recurringSettings":{"type":"array","items":{"type":"null"}},"automation":{"type":["string","null"],"format":"iri-reference"},"startDate":{"type":["string","null"],"format":"date-time"},"blockedFields":{"type":"array","items":{"type":"null"}}}}]},"HydraItemBaseSchema":{"type":"object","properties":{"@context":{"oneOf":[{"type":"string"},{"type":"object","properties":{"@vocab":{"type":"string"},"hydra":{"type":"string","enum":["http://www.w3.org/ns/hydra/core#"]}},"required":["@vocab","hydra"],"additionalProperties":true}]},"@id":{"type":"string"},"@type":{"type":"string"}},"required":["@id","@type"]},"MediaObject.jsonld":{"allOf":[{"$ref":"#/components/schemas/HydraItemBaseSchema"},{"type":"object","required":["file"],"properties":{"file":{"writeOnly":true,"type":["string","null"],"format":"binary"},"id":{"type":["string","null"]},"createdAt":{"type":["string","null"],"format":"date-time"},"name":{"type":["string","null"]},"size":{"type":["integer","null"]},"mimeType":{"type":["string","null"]},"contentId":{"type":["string","null"]},"updatedAt":{"type":["string","null"],"format":"date-time"},"publicUrl":{"type":["string","null"]}}}]},"Task":{"type":"object","properties":{"id":{"type":["string","null"]},"position":{"type":["integer","null"]},"totalComments":{"type":["integer","null"]},"title":{"type":["string","null"]},"description":{"type":["string","null"]},"isFlagged":{"type":["boolean","null"]},"isSubTask":{"type":["boolean","null"]},"indexNumber":{"type":["integer","null"]},"createdAt":{"type":["string","null"],"format":"date-time"},"updatedAt":{"type":["string","null"],"format":"date-time"},"completedAt":{"type":["string","null"],"format":"date-time"},"archivedAt":{"type":["string","null"],"format":"date-time"},"dueDate":{"type":["string","null"],"format":"date-time"},"workspace":{"type":["string","null"],"format":"iri-reference"},"status":{"type":["string","null"],"format":"iri-reference"},"author":{"type":["string","null"],"format":"iri-reference"},"parent":{"type":["string","null"],"format":"iri-reference"},"tags":{"type":"array","items":{"type":"string","format":"iri-reference"}},"assignees":{"type":"array","items":{"type":"string","format":"iri-reference"}},"observers":{"type":"array","items":{"type":"string","format":"iri-reference"}},"subTasks":{"anyOf":[{"type":"array","items":{"type":"string","format":"iri-reference"}},{"type":"array","items":{"type":"string","format":"iri-reference"}}]},"completedSubtasks":{"type":["integer","null"]},"totalSubtasks":{"type":["integer","null"]},"isTemplate":{"type":["boolean","null"]},"storyPointEstimation":{"type":["integer","null"]},"timeEstimation":{"type":["integer","null"]},"dealSizeEstimation":{"type":["integer","null"]},"messageProvider":{"type":["string","null"]},"scheduledOn":{"type":["string","null"]},"previouslyScheduledOn":{"type":["string","null"]},"plannedWeek":{"type":["string","null"]},"plannedMonth":{"type":["string","null"]},"snoozeUntil":{"type":["string","null"],"format":"date-time"},"isRecurring":{"type":["boolean","null"]},"workspaceType":{"type":["string","null"]},"files":{"type":"array","items":{"$ref":"#/components/schemas/MediaObject"}},"messages":{"type":"array","items":{"type":"null"}},"conversationItems":{"type":"array","items":{"type":"string","format":"iri-reference"}},"people":{"type":"array","items":{"type":"string","format":"iri-reference"}},"organizations":{"type":"array","items":{"type":"string","format":"iri-reference"}},"recurringSettings":{"type":"array","items":{"type":"null"}},"automation":{"type":["string","null"],"format":"iri-reference"},"startDate":{"type":["string","null"],"format":"date-time"},"blockedFields":{"type":"array","items":{"type":"null"}}}},"MediaObject":{"type":"object","required":["file"],"properties":{"file":{"writeOnly":true,"type":["string","null"],"format":"binary"},"id":{"type":["string","null"]},"createdAt":{"type":["string","null"],"format":"date-time"},"name":{"type":["string","null"]},"size":{"type":["integer","null"]},"mimeType":{"type":["string","null"]},"contentId":{"type":["string","null"]},"updatedAt":{"type":["string","null"],"format":"date-time"},"publicUrl":{"type":["string","null"]}}},"Error.jsonld":{"allOf":[{"$ref":"#/components/schemas/HydraItemBaseSchema"},{"type":"object","properties":{"title":{"readOnly":true,"description":"A short, human-readable summary of the problem.","type":["string","null"]},"detail":{"readOnly":true,"description":"A human-readable explanation specific to this occurrence of the problem.","type":["string","null"]},"status":{"type":"number","default":400},"instance":{"readOnly":true,"description":"A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.","type":["string","null"]},"type":{"readOnly":true,"description":"A URI reference that identifies the problem type","type":"string"},"description":{"readOnly":true,"type":["string","null"]}}}],"description":"A representation of common errors."},"Error":{"type":"object","description":"A representation of common errors.","properties":{"title":{"readOnly":true,"description":"A short, human-readable summary of the problem.","type":["string","null"]},"detail":{"readOnly":true,"description":"A human-readable explanation specific to this occurrence of the problem.","type":["string","null"]},"status":{"type":"number","default":400},"instance":{"readOnly":true,"description":"A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.","type":["string","null"]},"type":{"readOnly":true,"description":"A URI reference that identifies the problem type","type":"string"}}},"ConstraintViolation.jsonld":{"allOf":[{"$ref":"#/components/schemas/HydraItemBaseSchema"},{"type":"object","properties":{"status":{"default":422,"type":"integer"},"violations":{"type":"array","items":{"type":"object","properties":{"propertyPath":{"type":"string","description":"The property path of the violation"},"message":{"type":"string","description":"The message associated with the violation"}}}},"detail":{"readOnly":true,"type":"string"},"description":{"readOnly":true,"type":"string"},"type":{"readOnly":true,"type":"string"},"title":{"readOnly":true,"type":["string","null"]},"instance":{"readOnly":true,"type":["string","null"]}}}],"description":"Unprocessable entity"},"ConstraintViolation":{"type":"object","description":"Unprocessable entity","properties":{"status":{"default":422,"type":"integer"},"violations":{"type":"array","items":{"type":"object","properties":{"propertyPath":{"type":"string","description":"The property path of the violation"},"message":{"type":"string","description":"The message associated with the violation"}}}},"detail":{"readOnly":true,"type":"string"},"type":{"readOnly":true,"type":"string"},"title":{"readOnly":true,"type":["string","null"]},"instance":{"readOnly":true,"type":["string","null"]}}},"Task.CreateTaskPayload":{"type":"object","properties":{"parent":{"type":["string","null"],"format":"iri-reference"},"beforeTask":{"type":["string","null"],"format":"iri-reference"},"afterTask":{"type":["string","null"],"format":"iri-reference"},"positionTop":{"default":false,"type":["boolean","null"]},"participants":{"type":"array","items":{"type":"null"}},"title":{"description":"Title of task","type":["string","null"]},"description":{"description":"Short description of task","type":["string","null"]},"status":{"description":"Workspace","type":["string","null"],"format":"iri-reference"},"author":{"description":"Author of this task","type":["string","null"],"format":"iri-reference"},"assignees":{"type":"array","items":{"$ref":"#/components/schemas/User.HeartbeatPayload"}},"observers":{"type":"array","items":{"$ref":"#/components/schemas/User.HeartbeatPayload"}},"tags":{"type":"array","items":{"$ref":"#/components/schemas/Tag"}},"people":{"type":"array","items":{"$ref":"#/components/schemas/Person"}},"organizations":{"type":"array","items":{"$ref":"#/components/schemas/Organization"}},"messages":{"type":"array","items":{"$ref":"#/components/schemas/Message"}},"conversationItems":{"type":"array","items":{"$ref":"#/components/schemas/ConversationItem.ConversationItemChatPayload"}},"isFlagged":{"description":"Highlight this task","default":false,"type":"boolean"},"archivedAt":{"description":"Archive task","type":["string","null"],"format":"date-time"},"dueDate":{"description":"Date when this task is due","type":["string","null"],"format":"date-time"},"isTemplate":{"description":"Task is a template","default":false,"type":"boolean"},"storyPointEstimation":{"type":["integer","null"]},"dealSizeEstimation":{"type":["integer","null"]},"timeEstimation":{"maximum":4294967295,"type":["integer","null"]},"scheduledOn":{"description":"Date when task is scheduled","type":["string","null"],"format":"date-time"},"plannedWeek":{"description":"Date when task is planned in week","type":["string","null"],"format":"date-time"},"plannedMonth":{"description":"Date when task is planned in month","type":["string","null"],"format":"date-time"},"snoozeUntil":{"description":"Snooze task until","type":["string","null"],"format":"date-time"}},"required":["title"]},"User.HeartbeatPayload":{"type":"object"},"Tag":{"type":"object","properties":{"id":{"type":["string","null"]},"backgroundColor":{"type":["string","null"]},"textColor":{"type":["string","null"]},"title":{"type":["string","null"]},"description":{"type":["string","null"]},"createdAt":{"type":["string","null"],"format":"date-time"},"updatedAt":{"type":["string","null"],"format":"date-time"}},"required":["title"]},"Person":{"type":"object","description":"Represents a CRM contact person with details like name, email, phone, and tags.","required":["familyName"],"properties":{"familyName":{"type":["string","null"]},"givenName":{"type":["string","null"]},"additionalName":{"type":["string","null"]},"initials":{"type":["string","null"]},"customerId":{"type":["string","null"]},"honorificPrefix":{"type":["string","null"]},"isTracked":{"type":["boolean","null"]},"linkedinId":{"type":["string","null"]},"externalSource":{"type":["string","null"]},"createdAt":{"readOnly":true,"type":["string","null"],"format":"date-time"},"updatedAt":{"readOnly":true,"type":["string","null"],"format":"date-time"},"importedAt":{"readOnly":true,"type":["string","null"],"format":"date-time"},"archivedAt":{"type":["string","null"],"format":"date-time"},"owner":{"type":["string","null"],"format":"iri-reference"},"jobTitle":{"type":["string","null"]},"tags":{"type":"array","items":{"type":"string","format":"iri-reference"}},"segments":{"type":"array","items":{"type":"string","format":"iri-reference"}},"organizations":{"type":"array","items":{"type":"string","format":"iri-reference"}},"_organizations":{"readOnly":true,"deprecated":true,"type":"array","items":{"type":"null"}},"emailAddresses":{"type":"array","items":{"$ref":"#/components/schemas/EmailAddressPayload_noid"}},"phoneNumbers":{"type":"array","items":{"$ref":"#/components/schemas/PhoneNumberPayload_noid"}},"address":{"$ref":"#/components/schemas/AddressPayload"},"avatarUrl":{"readOnly":true,"type":["string","null"]},"avatar":{"writeOnly":true,"type":["string","null"],"format":"iri-reference"},"dealSize":{"type":["integer","null"]},"totalDeals":{"type":["integer","null"]},"totalLostDeals":{"type":["integer","null"]},"totalWonDeals":{"type":["integer","null"]},"linkedinEnrichment":{"readOnly":true,"type":["array","null"],"items":{"type":"null"}},"id":{"type":["string","null"]}}},"EmailAddressPayload_noid":{"type":"object","required":["email"],"properties":{"email":{"format":"email","type":["string","null"]}}},"PhoneNumberPayload_noid":{"type":"object","required":["phoneNumber","phoneType"],"properties":{"phoneNumber":{"type":["string","null"]},"phoneType":{"enum":["fax","mobile","home","work"],"type":["string","null"]}}},"AddressPayload":{"type":"object","properties":{"city":{"type":["string","null"]},"postalCode":{"type":["string","null"]},"street":{"type":["string","null"]},"country":{"default":"NL","type":["string","null"]}}},"Organization":{"type":"object","description":"Represents an organization in the CRM with name, contact details, tags, and related people.","properties":{"description":{"type":["string","null"]},"emailAddresses":{"type":"array","items":{"$ref":"#/components/schemas/EmailAddressPayload_noid"}},"phoneNumbers":{"type":"array","items":{"$ref":"#/components/schemas/PhoneNumberPayload_noid"}},"title":{"type":["string","null"]},"website":{"type":["string","null"]},"customerId":{"type":["string","null"]},"externalSource":{"type":["string","null"]},"chamberOfCommerceNumber":{"type":["string","null"]},"linkedinId":{"type":["string","null"]},"linkedinPublicIdentifier":{"readOnly":true,"type":["string","null"]},"linkedinInternalId":{"readOnly":true,"type":["string","null"]},"createdAt":{"readOnly":true,"type":["string","null"],"format":"date-time"},"importedAt":{"readOnly":true,"type":["string","null"],"format":"date-time"},"updatedAt":{"readOnly":true,"type":["string","null"],"format":"date-time"},"archivedAt":{"type":["string","null"],"format":"date-time"},"address":{"$ref":"#/components/schemas/AddressPayload"},"owner":{"type":["string","null"],"format":"iri-reference"},"people":{"type":"array","items":{"type":"string","format":"iri-reference"}},"avatarUrl":{"readOnly":true,"type":["string","null"]},"avatar":{"writeOnly":true,"type":["string","null"],"format":"iri-reference"},"tags":{"type":"array","items":{"type":"string","format":"iri-reference"}},"segments":{"type":"array","items":{"type":"string","format":"iri-reference"}},"integrationParticipants":{"type":"array","items":{"type":"string","format":"iri-reference"}},"companyEnrichment":{"readOnly":true,"type":["boolean","null"]},"linkedinCompanyEnrichment":{"readOnly":true,"type":["array","null"],"items":{"type":"null"}},"id":{"type":["string","null"]}},"required":["title"]},"Message":{"type":"object","properties":{"emailAccount":{"anyOf":[{"$ref":"#/components/schemas/EmailAccount"},{"type":"null"}]},"dateSent":{"type":["string","null"],"format":"date-time"},"subject":{"type":["string","null"]},"userSubject":{"type":["string","null"]},"snippet":{"type":["string","null"]},"attachments":{"type":"array","items":{"type":"null"}},"labels":{"type":"array","items":{"type":"null"}},"tags":{"type":"array","items":{"type":"string","format":"iri-reference"}},"hasAttachments":{"default":false,"type":"boolean"},"read":{"default":false,"type":"boolean"},"starred":{"default":false,"type":"boolean"},"sent":{"default":false,"type":"boolean"},"attachmentsInline":{"type":"array","items":{"type":"null"}},"provider":{"type":["string","null"]},"participants":{"type":"array","items":{"type":"null"}},"tasks":{"type":"array","items":{"$ref":"#/components/schemas/Task"}},"from":{"type":"array","items":{"type":"null"}},"to":{"type":"array","items":{"type":"null"}},"cc":{"type":"array","items":{"type":"null"}},"bcc":{"type":"array","items":{"type":"null"}},"owner":{"default":false,"type":"boolean"},"hasAccess":{"default":false,"type":"boolean"},"write":{"default":false,"type":"boolean"},"conversationId":{"type":["string","null"]},"user":{"type":["string","null"],"format":"iri-reference"},"body":{"type":["string","null"]},"id":{"type":["string","null"]}}},"EmailAccount":{"type":"object","required":["label","emailAccountType","fromName","shareType"],"properties":{"label":{"type":["string","null"]},"emailAccountType":{"enum":["group","person"],"type":["string","null"]},"email":{"type":["string","null"]},"fromName":{"type":["string","null"]},"shareType":{"enum":["all","none","crm"],"type":["string","null"]},"color":{"type":["string","null"]},"createdAt":{"type":["string","null"],"format":"date-time"},"authorized":{"type":["boolean","null"]},"integrationData":{"type":"array","items":{"type":"null"}},"owner":{"type":["string","null"],"format":"iri-reference"},"provider":{"anyOf":[{"$ref":"#/components/schemas/Integration"},{"type":"null"}]},"signaturesNew":{"type":"array","items":{"type":"string","format":"iri-reference"}},"signaturesReply":{"type":"array","items":{"type":"string","format":"iri-reference"}},"id":{"type":["string","null"]}}},"Integration":{"type":"object","properties":{"title":{"type":["string","null"]},"isDevelopment":{"default":false,"type":"boolean"},"category":{"type":["string","null"]},"description":{"type":["string","null"]},"privacyDescription":{"type":["string","null"]},"authUrl":{"type":["string","null"]},"redirectUrl":{"type":["string","null"]},"id":{"type":["string","null"]}}},"ConversationItem.ConversationItemChatPayload":{"type":"object","properties":{"replyTo":{"type":["string","null"],"format":"iri-reference"},"body":{"type":["string","null"]},"mentions":{"type":"array","items":{"$ref":"#/components/schemas/User.HeartbeatPayload"}},"attachments":{"type":"array","items":{"$ref":"#/components/schemas/MediaObject"}}},"required":["body"]}}},"paths":{"/tasks":{"post":{"operationId":"api_tasks_post","tags":["Task"],"responses":{"201":{"description":"Task resource created","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/Task.jsonld"}},"application/json":{"schema":{"$ref":"#/components/schemas/Task"}}},"links":{}},"400":{"description":"Invalid input","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/Error.jsonld"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}},"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"links":{}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/Error.jsonld"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}},"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"links":{}},"422":{"description":"An error occurred","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/ConstraintViolation.jsonld"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/ConstraintViolation"}},"application/json":{"schema":{"$ref":"#/components/schemas/ConstraintViolation"}}},"links":{}}},"summary":"Creates a Task resource.","description":"Creates a Task resource.","parameters":[],"requestBody":{"description":"The new Task resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/Task.CreateTaskPayload"}},"application/json":{"schema":{"$ref":"#/components/schemas/Task.CreateTaskPayload"}}},"required":true}}}}}
```

## Creates a Task resource.

> Creates a Task resource.

```json
{"openapi":"3.1.0","info":{"title":"RogerRoger API","version":"1.0.0"},"tags":[{"name":"Task","description":"Resource 'Task' operations."}],"servers":[{"url":"https://api.rogerroger.io","description":"API"}],"security":[{"BearerAuth":[]},{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","description":"Your API key, available from the dashboard","name":"X-API-KEY","in":"header"}},"schemas":{"Task.jsonld":{"allOf":[{"$ref":"#/components/schemas/HydraItemBaseSchema"},{"type":"object","properties":{"id":{"type":["string","null"]},"position":{"type":["integer","null"]},"totalComments":{"type":["integer","null"]},"title":{"type":["string","null"]},"description":{"type":["string","null"]},"isFlagged":{"type":["boolean","null"]},"isSubTask":{"type":["boolean","null"]},"indexNumber":{"type":["integer","null"]},"createdAt":{"type":["string","null"],"format":"date-time"},"updatedAt":{"type":["string","null"],"format":"date-time"},"completedAt":{"type":["string","null"],"format":"date-time"},"archivedAt":{"type":["string","null"],"format":"date-time"},"dueDate":{"type":["string","null"],"format":"date-time"},"workspace":{"type":["string","null"],"format":"iri-reference"},"status":{"type":["string","null"],"format":"iri-reference"},"author":{"type":["string","null"],"format":"iri-reference"},"parent":{"type":["string","null"],"format":"iri-reference"},"tags":{"type":"array","items":{"type":"string","format":"iri-reference"}},"assignees":{"type":"array","items":{"type":"string","format":"iri-reference"}},"observers":{"type":"array","items":{"type":"string","format":"iri-reference"}},"subTasks":{"anyOf":[{"type":"array","items":{"type":"string","format":"iri-reference"}},{"type":"array","items":{"type":"string","format":"iri-reference"}}]},"completedSubtasks":{"type":["integer","null"]},"totalSubtasks":{"type":["integer","null"]},"isTemplate":{"type":["boolean","null"]},"storyPointEstimation":{"type":["integer","null"]},"timeEstimation":{"type":["integer","null"]},"dealSizeEstimation":{"type":["integer","null"]},"messageProvider":{"type":["string","null"]},"scheduledOn":{"type":["string","null"]},"previouslyScheduledOn":{"type":["string","null"]},"plannedWeek":{"type":["string","null"]},"plannedMonth":{"type":["string","null"]},"snoozeUntil":{"type":["string","null"],"format":"date-time"},"isRecurring":{"type":["boolean","null"]},"workspaceType":{"type":["string","null"]},"files":{"type":"array","items":{"$ref":"#/components/schemas/MediaObject.jsonld"}},"messages":{"type":"array","items":{"type":"null"}},"conversationItems":{"type":"array","items":{"type":"string","format":"iri-reference"}},"people":{"type":"array","items":{"type":"string","format":"iri-reference"}},"organizations":{"type":"array","items":{"type":"string","format":"iri-reference"}},"recurringSettings":{"type":"array","items":{"type":"null"}},"automation":{"type":["string","null"],"format":"iri-reference"},"startDate":{"type":["string","null"],"format":"date-time"},"blockedFields":{"type":"array","items":{"type":"null"}}}}]},"HydraItemBaseSchema":{"type":"object","properties":{"@context":{"oneOf":[{"type":"string"},{"type":"object","properties":{"@vocab":{"type":"string"},"hydra":{"type":"string","enum":["http://www.w3.org/ns/hydra/core#"]}},"required":["@vocab","hydra"],"additionalProperties":true}]},"@id":{"type":"string"},"@type":{"type":"string"}},"required":["@id","@type"]},"MediaObject.jsonld":{"allOf":[{"$ref":"#/components/schemas/HydraItemBaseSchema"},{"type":"object","required":["file"],"properties":{"file":{"writeOnly":true,"type":["string","null"],"format":"binary"},"id":{"type":["string","null"]},"createdAt":{"type":["string","null"],"format":"date-time"},"name":{"type":["string","null"]},"size":{"type":["integer","null"]},"mimeType":{"type":["string","null"]},"contentId":{"type":["string","null"]},"updatedAt":{"type":["string","null"],"format":"date-time"},"publicUrl":{"type":["string","null"]}}}]},"Task":{"type":"object","properties":{"id":{"type":["string","null"]},"position":{"type":["integer","null"]},"totalComments":{"type":["integer","null"]},"title":{"type":["string","null"]},"description":{"type":["string","null"]},"isFlagged":{"type":["boolean","null"]},"isSubTask":{"type":["boolean","null"]},"indexNumber":{"type":["integer","null"]},"createdAt":{"type":["string","null"],"format":"date-time"},"updatedAt":{"type":["string","null"],"format":"date-time"},"completedAt":{"type":["string","null"],"format":"date-time"},"archivedAt":{"type":["string","null"],"format":"date-time"},"dueDate":{"type":["string","null"],"format":"date-time"},"workspace":{"type":["string","null"],"format":"iri-reference"},"status":{"type":["string","null"],"format":"iri-reference"},"author":{"type":["string","null"],"format":"iri-reference"},"parent":{"type":["string","null"],"format":"iri-reference"},"tags":{"type":"array","items":{"type":"string","format":"iri-reference"}},"assignees":{"type":"array","items":{"type":"string","format":"iri-reference"}},"observers":{"type":"array","items":{"type":"string","format":"iri-reference"}},"subTasks":{"anyOf":[{"type":"array","items":{"type":"string","format":"iri-reference"}},{"type":"array","items":{"type":"string","format":"iri-reference"}}]},"completedSubtasks":{"type":["integer","null"]},"totalSubtasks":{"type":["integer","null"]},"isTemplate":{"type":["boolean","null"]},"storyPointEstimation":{"type":["integer","null"]},"timeEstimation":{"type":["integer","null"]},"dealSizeEstimation":{"type":["integer","null"]},"messageProvider":{"type":["string","null"]},"scheduledOn":{"type":["string","null"]},"previouslyScheduledOn":{"type":["string","null"]},"plannedWeek":{"type":["string","null"]},"plannedMonth":{"type":["string","null"]},"snoozeUntil":{"type":["string","null"],"format":"date-time"},"isRecurring":{"type":["boolean","null"]},"workspaceType":{"type":["string","null"]},"files":{"type":"array","items":{"$ref":"#/components/schemas/MediaObject"}},"messages":{"type":"array","items":{"type":"null"}},"conversationItems":{"type":"array","items":{"type":"string","format":"iri-reference"}},"people":{"type":"array","items":{"type":"string","format":"iri-reference"}},"organizations":{"type":"array","items":{"type":"string","format":"iri-reference"}},"recurringSettings":{"type":"array","items":{"type":"null"}},"automation":{"type":["string","null"],"format":"iri-reference"},"startDate":{"type":["string","null"],"format":"date-time"},"blockedFields":{"type":"array","items":{"type":"null"}}}},"MediaObject":{"type":"object","required":["file"],"properties":{"file":{"writeOnly":true,"type":["string","null"],"format":"binary"},"id":{"type":["string","null"]},"createdAt":{"type":["string","null"],"format":"date-time"},"name":{"type":["string","null"]},"size":{"type":["integer","null"]},"mimeType":{"type":["string","null"]},"contentId":{"type":["string","null"]},"updatedAt":{"type":["string","null"],"format":"date-time"},"publicUrl":{"type":["string","null"]}}},"Error.jsonld":{"allOf":[{"$ref":"#/components/schemas/HydraItemBaseSchema"},{"type":"object","properties":{"title":{"readOnly":true,"description":"A short, human-readable summary of the problem.","type":["string","null"]},"detail":{"readOnly":true,"description":"A human-readable explanation specific to this occurrence of the problem.","type":["string","null"]},"status":{"type":"number","default":400},"instance":{"readOnly":true,"description":"A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.","type":["string","null"]},"type":{"readOnly":true,"description":"A URI reference that identifies the problem type","type":"string"},"description":{"readOnly":true,"type":["string","null"]}}}],"description":"A representation of common errors."},"Error":{"type":"object","description":"A representation of common errors.","properties":{"title":{"readOnly":true,"description":"A short, human-readable summary of the problem.","type":["string","null"]},"detail":{"readOnly":true,"description":"A human-readable explanation specific to this occurrence of the problem.","type":["string","null"]},"status":{"type":"number","default":400},"instance":{"readOnly":true,"description":"A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.","type":["string","null"]},"type":{"readOnly":true,"description":"A URI reference that identifies the problem type","type":"string"}}},"ConstraintViolation.jsonld":{"allOf":[{"$ref":"#/components/schemas/HydraItemBaseSchema"},{"type":"object","properties":{"status":{"default":422,"type":"integer"},"violations":{"type":"array","items":{"type":"object","properties":{"propertyPath":{"type":"string","description":"The property path of the violation"},"message":{"type":"string","description":"The message associated with the violation"}}}},"detail":{"readOnly":true,"type":"string"},"description":{"readOnly":true,"type":"string"},"type":{"readOnly":true,"type":"string"},"title":{"readOnly":true,"type":["string","null"]},"instance":{"readOnly":true,"type":["string","null"]}}}],"description":"Unprocessable entity"},"ConstraintViolation":{"type":"object","description":"Unprocessable entity","properties":{"status":{"default":422,"type":"integer"},"violations":{"type":"array","items":{"type":"object","properties":{"propertyPath":{"type":"string","description":"The property path of the violation"},"message":{"type":"string","description":"The message associated with the violation"}}}},"detail":{"readOnly":true,"type":"string"},"type":{"readOnly":true,"type":"string"},"title":{"readOnly":true,"type":["string","null"]},"instance":{"readOnly":true,"type":["string","null"]}}},"Task.DuplicateTaskPayload":{"type":"object","description":"Duplicate task","properties":{"status":{"description":"Set status","type":["string","null"],"format":"iri-reference"},"title":{"type":["string","null"]},"isTemplate":{"default":false,"type":"boolean"},"people":{"type":"array","items":{"$ref":"#/components/schemas/Person"}},"organizations":{"type":"array","items":{"$ref":"#/components/schemas/Organization"}}}},"Person":{"type":"object","description":"Represents a CRM contact person with details like name, email, phone, and tags.","required":["familyName"],"properties":{"familyName":{"type":["string","null"]},"givenName":{"type":["string","null"]},"additionalName":{"type":["string","null"]},"initials":{"type":["string","null"]},"customerId":{"type":["string","null"]},"honorificPrefix":{"type":["string","null"]},"isTracked":{"type":["boolean","null"]},"linkedinId":{"type":["string","null"]},"externalSource":{"type":["string","null"]},"createdAt":{"readOnly":true,"type":["string","null"],"format":"date-time"},"updatedAt":{"readOnly":true,"type":["string","null"],"format":"date-time"},"importedAt":{"readOnly":true,"type":["string","null"],"format":"date-time"},"archivedAt":{"type":["string","null"],"format":"date-time"},"owner":{"type":["string","null"],"format":"iri-reference"},"jobTitle":{"type":["string","null"]},"tags":{"type":"array","items":{"type":"string","format":"iri-reference"}},"segments":{"type":"array","items":{"type":"string","format":"iri-reference"}},"organizations":{"type":"array","items":{"type":"string","format":"iri-reference"}},"_organizations":{"readOnly":true,"deprecated":true,"type":"array","items":{"type":"null"}},"emailAddresses":{"type":"array","items":{"$ref":"#/components/schemas/EmailAddressPayload_noid"}},"phoneNumbers":{"type":"array","items":{"$ref":"#/components/schemas/PhoneNumberPayload_noid"}},"address":{"$ref":"#/components/schemas/AddressPayload"},"avatarUrl":{"readOnly":true,"type":["string","null"]},"avatar":{"writeOnly":true,"type":["string","null"],"format":"iri-reference"},"dealSize":{"type":["integer","null"]},"totalDeals":{"type":["integer","null"]},"totalLostDeals":{"type":["integer","null"]},"totalWonDeals":{"type":["integer","null"]},"linkedinEnrichment":{"readOnly":true,"type":["array","null"],"items":{"type":"null"}},"id":{"type":["string","null"]}}},"EmailAddressPayload_noid":{"type":"object","required":["email"],"properties":{"email":{"format":"email","type":["string","null"]}}},"PhoneNumberPayload_noid":{"type":"object","required":["phoneNumber","phoneType"],"properties":{"phoneNumber":{"type":["string","null"]},"phoneType":{"enum":["fax","mobile","home","work"],"type":["string","null"]}}},"AddressPayload":{"type":"object","properties":{"city":{"type":["string","null"]},"postalCode":{"type":["string","null"]},"street":{"type":["string","null"]},"country":{"default":"NL","type":["string","null"]}}},"Organization":{"type":"object","description":"Represents an organization in the CRM with name, contact details, tags, and related people.","properties":{"description":{"type":["string","null"]},"emailAddresses":{"type":"array","items":{"$ref":"#/components/schemas/EmailAddressPayload_noid"}},"phoneNumbers":{"type":"array","items":{"$ref":"#/components/schemas/PhoneNumberPayload_noid"}},"title":{"type":["string","null"]},"website":{"type":["string","null"]},"customerId":{"type":["string","null"]},"externalSource":{"type":["string","null"]},"chamberOfCommerceNumber":{"type":["string","null"]},"linkedinId":{"type":["string","null"]},"linkedinPublicIdentifier":{"readOnly":true,"type":["string","null"]},"linkedinInternalId":{"readOnly":true,"type":["string","null"]},"createdAt":{"readOnly":true,"type":["string","null"],"format":"date-time"},"importedAt":{"readOnly":true,"type":["string","null"],"format":"date-time"},"updatedAt":{"readOnly":true,"type":["string","null"],"format":"date-time"},"archivedAt":{"type":["string","null"],"format":"date-time"},"address":{"$ref":"#/components/schemas/AddressPayload"},"owner":{"type":["string","null"],"format":"iri-reference"},"people":{"type":"array","items":{"type":"string","format":"iri-reference"}},"avatarUrl":{"readOnly":true,"type":["string","null"]},"avatar":{"writeOnly":true,"type":["string","null"],"format":"iri-reference"},"tags":{"type":"array","items":{"type":"string","format":"iri-reference"}},"segments":{"type":"array","items":{"type":"string","format":"iri-reference"}},"integrationParticipants":{"type":"array","items":{"type":"string","format":"iri-reference"}},"companyEnrichment":{"readOnly":true,"type":["boolean","null"]},"linkedinCompanyEnrichment":{"readOnly":true,"type":["array","null"],"items":{"type":"null"}},"id":{"type":["string","null"]}},"required":["title"]}}},"paths":{"/tasks/{id}/duplicate":{"post":{"operationId":"api_tasks_idduplicate_post","tags":["Task"],"responses":{"201":{"description":"Task resource created","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/Task.jsonld"}},"application/json":{"schema":{"$ref":"#/components/schemas/Task"}}},"links":{}},"400":{"description":"Invalid input","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/Error.jsonld"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}},"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"links":{}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/Error.jsonld"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}},"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"links":{}},"422":{"description":"An error occurred","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/ConstraintViolation.jsonld"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/ConstraintViolation"}},"application/json":{"schema":{"$ref":"#/components/schemas/ConstraintViolation"}}},"links":{}}},"summary":"Creates a Task resource.","description":"Creates a Task resource.","parameters":[{"name":"id","in":"path","description":"Task identifier","required":true,"deprecated":false,"schema":{"type":"string"},"style":"simple","explode":false}],"requestBody":{"description":"The new Task resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/Task.DuplicateTaskPayload"}},"application/json":{"schema":{"$ref":"#/components/schemas/Task.DuplicateTaskPayload"}}},"required":true}}}}}
```

## Creates a Task resource.

> Creates a Task resource.

```json
{"openapi":"3.1.0","info":{"title":"RogerRoger API","version":"1.0.0"},"tags":[{"name":"Task","description":"Resource 'Task' operations."}],"servers":[{"url":"https://api.rogerroger.io","description":"API"}],"security":[{"BearerAuth":[]},{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","description":"Your API key, available from the dashboard","name":"X-API-KEY","in":"header"}}},"paths":{"/tasks/{id}/export":{"post":{"operationId":"api_tasks_idexport_post","tags":["Task"],"responses":{"204":{"description":"Task resource created","links":{}},"400":{"description":"Invalid input","links":{}},"403":{"description":"Forbidden","links":{}},"422":{"description":"An error occurred","links":{}}},"summary":"Creates a Task resource.","description":"Creates a Task resource.","parameters":[{"name":"id","in":"path","description":"Task identifier","required":true,"deprecated":false,"schema":{"type":"string"},"style":"simple","explode":false}]}}}}
```

## Creates a TaskCommentResource resource.

> Creates a TaskCommentResource resource.

```json
{"openapi":"3.1.0","info":{"title":"RogerRoger API","version":"1.0.0"},"tags":[{"name":"Tasks","description":"Resource 'Tasks' operations."}],"servers":[{"url":"https://api.rogerroger.io","description":"API"}],"security":[{"BearerAuth":[]},{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","description":"Your API key, available from the dashboard","name":"X-API-KEY","in":"header"}},"schemas":{"TaskCommentResource.jsonld":{"allOf":[{"$ref":"#/components/schemas/HydraItemBaseSchema"},{"type":"object","properties":{"id":{"type":["string","null"]},"taskId":{"writeOnly":true,"type":["string","null"]},"createdAt":{"type":["string","null"],"format":"date-time"},"description":{"type":["string","null"]},"flagged":{"type":["boolean","null"]},"author":{"type":["string","null"],"format":"iri-reference"},"mentions":{"type":"array","items":{"type":"string","format":"iri-reference"}}},"required":["description"]}]},"HydraItemBaseSchema":{"type":"object","properties":{"@context":{"oneOf":[{"type":"string"},{"type":"object","properties":{"@vocab":{"type":"string"},"hydra":{"type":"string","enum":["http://www.w3.org/ns/hydra/core#"]}},"required":["@vocab","hydra"],"additionalProperties":true}]},"@id":{"type":"string"},"@type":{"type":"string"}},"required":["@id","@type"]},"TaskCommentResource":{"type":"object","properties":{"id":{"type":["string","null"]},"taskId":{"writeOnly":true,"type":["string","null"]},"createdAt":{"type":["string","null"],"format":"date-time"},"description":{"type":["string","null"]},"flagged":{"type":["boolean","null"]},"author":{"type":["string","null"],"format":"iri-reference"},"mentions":{"type":"array","items":{"type":"string","format":"iri-reference"}}},"required":["description"]},"Error.jsonld":{"allOf":[{"$ref":"#/components/schemas/HydraItemBaseSchema"},{"type":"object","properties":{"title":{"readOnly":true,"description":"A short, human-readable summary of the problem.","type":["string","null"]},"detail":{"readOnly":true,"description":"A human-readable explanation specific to this occurrence of the problem.","type":["string","null"]},"status":{"type":"number","default":400},"instance":{"readOnly":true,"description":"A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.","type":["string","null"]},"type":{"readOnly":true,"description":"A URI reference that identifies the problem type","type":"string"},"description":{"readOnly":true,"type":["string","null"]}}}],"description":"A representation of common errors."},"Error":{"type":"object","description":"A representation of common errors.","properties":{"title":{"readOnly":true,"description":"A short, human-readable summary of the problem.","type":["string","null"]},"detail":{"readOnly":true,"description":"A human-readable explanation specific to this occurrence of the problem.","type":["string","null"]},"status":{"type":"number","default":400},"instance":{"readOnly":true,"description":"A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.","type":["string","null"]},"type":{"readOnly":true,"description":"A URI reference that identifies the problem type","type":"string"}}},"ConstraintViolation.jsonld":{"allOf":[{"$ref":"#/components/schemas/HydraItemBaseSchema"},{"type":"object","properties":{"status":{"default":422,"type":"integer"},"violations":{"type":"array","items":{"type":"object","properties":{"propertyPath":{"type":"string","description":"The property path of the violation"},"message":{"type":"string","description":"The message associated with the violation"}}}},"detail":{"readOnly":true,"type":"string"},"description":{"readOnly":true,"type":"string"},"type":{"readOnly":true,"type":"string"},"title":{"readOnly":true,"type":["string","null"]},"instance":{"readOnly":true,"type":["string","null"]}}}],"description":"Unprocessable entity"},"ConstraintViolation":{"type":"object","description":"Unprocessable entity","properties":{"status":{"default":422,"type":"integer"},"violations":{"type":"array","items":{"type":"object","properties":{"propertyPath":{"type":"string","description":"The property path of the violation"},"message":{"type":"string","description":"The message associated with the violation"}}}},"detail":{"readOnly":true,"type":"string"},"type":{"readOnly":true,"type":"string"},"title":{"readOnly":true,"type":["string","null"]},"instance":{"readOnly":true,"type":["string","null"]}}}}},"paths":{"/tasks/{taskId}/comments":{"post":{"operationId":"api_tasks_taskIdcomments_post","tags":["Tasks"],"responses":{"201":{"description":"TaskCommentResource resource created","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/TaskCommentResource.jsonld"}},"application/json":{"schema":{"$ref":"#/components/schemas/TaskCommentResource"}}},"links":{}},"400":{"description":"Invalid input","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/Error.jsonld"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}},"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"links":{}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/Error.jsonld"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}},"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"links":{}},"422":{"description":"An error occurred","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/ConstraintViolation.jsonld"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/ConstraintViolation"}},"application/json":{"schema":{"$ref":"#/components/schemas/ConstraintViolation"}}},"links":{}}},"summary":"Creates a TaskCommentResource resource.","description":"Creates a TaskCommentResource resource.","parameters":[{"name":"taskId","in":"path","description":"TaskCommentResource identifier","required":true,"deprecated":false,"schema":{"type":"string"},"style":"simple","explode":false}],"requestBody":{"description":"The new TaskCommentResource resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/TaskCommentResource"}},"application/json":{"schema":{"$ref":"#/components/schemas/TaskCommentResource"}}},"required":true}}}}}
```

## Retrieves a Task resource.

> Retrieves a Task resource.

```json
{"openapi":"3.1.0","info":{"title":"RogerRoger API","version":"1.0.0"},"tags":[{"name":"Task","description":"Resource 'Task' operations."}],"servers":[{"url":"https://api.rogerroger.io","description":"API"}],"security":[{"BearerAuth":[]},{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","description":"Your API key, available from the dashboard","name":"X-API-KEY","in":"header"}},"schemas":{"Task.jsonld":{"allOf":[{"$ref":"#/components/schemas/HydraItemBaseSchema"},{"type":"object","properties":{"id":{"type":["string","null"]},"position":{"type":["integer","null"]},"totalComments":{"type":["integer","null"]},"title":{"type":["string","null"]},"description":{"type":["string","null"]},"isFlagged":{"type":["boolean","null"]},"isSubTask":{"type":["boolean","null"]},"indexNumber":{"type":["integer","null"]},"createdAt":{"type":["string","null"],"format":"date-time"},"updatedAt":{"type":["string","null"],"format":"date-time"},"completedAt":{"type":["string","null"],"format":"date-time"},"archivedAt":{"type":["string","null"],"format":"date-time"},"dueDate":{"type":["string","null"],"format":"date-time"},"workspace":{"type":["string","null"],"format":"iri-reference"},"status":{"type":["string","null"],"format":"iri-reference"},"author":{"type":["string","null"],"format":"iri-reference"},"parent":{"type":["string","null"],"format":"iri-reference"},"tags":{"type":"array","items":{"type":"string","format":"iri-reference"}},"assignees":{"type":"array","items":{"type":"string","format":"iri-reference"}},"observers":{"type":"array","items":{"type":"string","format":"iri-reference"}},"subTasks":{"anyOf":[{"type":"array","items":{"type":"string","format":"iri-reference"}},{"type":"array","items":{"type":"string","format":"iri-reference"}}]},"completedSubtasks":{"type":["integer","null"]},"totalSubtasks":{"type":["integer","null"]},"isTemplate":{"type":["boolean","null"]},"storyPointEstimation":{"type":["integer","null"]},"timeEstimation":{"type":["integer","null"]},"dealSizeEstimation":{"type":["integer","null"]},"messageProvider":{"type":["string","null"]},"scheduledOn":{"type":["string","null"]},"previouslyScheduledOn":{"type":["string","null"]},"plannedWeek":{"type":["string","null"]},"plannedMonth":{"type":["string","null"]},"snoozeUntil":{"type":["string","null"],"format":"date-time"},"isRecurring":{"type":["boolean","null"]},"workspaceType":{"type":["string","null"]},"files":{"type":"array","items":{"$ref":"#/components/schemas/MediaObject.jsonld"}},"messages":{"type":"array","items":{"type":"null"}},"conversationItems":{"type":"array","items":{"type":"string","format":"iri-reference"}},"people":{"type":"array","items":{"type":"string","format":"iri-reference"}},"organizations":{"type":"array","items":{"type":"string","format":"iri-reference"}},"recurringSettings":{"type":"array","items":{"type":"null"}},"automation":{"type":["string","null"],"format":"iri-reference"},"startDate":{"type":["string","null"],"format":"date-time"},"blockedFields":{"type":"array","items":{"type":"null"}}}}]},"HydraItemBaseSchema":{"type":"object","properties":{"@context":{"oneOf":[{"type":"string"},{"type":"object","properties":{"@vocab":{"type":"string"},"hydra":{"type":"string","enum":["http://www.w3.org/ns/hydra/core#"]}},"required":["@vocab","hydra"],"additionalProperties":true}]},"@id":{"type":"string"},"@type":{"type":"string"}},"required":["@id","@type"]},"MediaObject.jsonld":{"allOf":[{"$ref":"#/components/schemas/HydraItemBaseSchema"},{"type":"object","required":["file"],"properties":{"file":{"writeOnly":true,"type":["string","null"],"format":"binary"},"id":{"type":["string","null"]},"createdAt":{"type":["string","null"],"format":"date-time"},"name":{"type":["string","null"]},"size":{"type":["integer","null"]},"mimeType":{"type":["string","null"]},"contentId":{"type":["string","null"]},"updatedAt":{"type":["string","null"],"format":"date-time"},"publicUrl":{"type":["string","null"]}}}]},"Task":{"type":"object","properties":{"id":{"type":["string","null"]},"position":{"type":["integer","null"]},"totalComments":{"type":["integer","null"]},"title":{"type":["string","null"]},"description":{"type":["string","null"]},"isFlagged":{"type":["boolean","null"]},"isSubTask":{"type":["boolean","null"]},"indexNumber":{"type":["integer","null"]},"createdAt":{"type":["string","null"],"format":"date-time"},"updatedAt":{"type":["string","null"],"format":"date-time"},"completedAt":{"type":["string","null"],"format":"date-time"},"archivedAt":{"type":["string","null"],"format":"date-time"},"dueDate":{"type":["string","null"],"format":"date-time"},"workspace":{"type":["string","null"],"format":"iri-reference"},"status":{"type":["string","null"],"format":"iri-reference"},"author":{"type":["string","null"],"format":"iri-reference"},"parent":{"type":["string","null"],"format":"iri-reference"},"tags":{"type":"array","items":{"type":"string","format":"iri-reference"}},"assignees":{"type":"array","items":{"type":"string","format":"iri-reference"}},"observers":{"type":"array","items":{"type":"string","format":"iri-reference"}},"subTasks":{"anyOf":[{"type":"array","items":{"type":"string","format":"iri-reference"}},{"type":"array","items":{"type":"string","format":"iri-reference"}}]},"completedSubtasks":{"type":["integer","null"]},"totalSubtasks":{"type":["integer","null"]},"isTemplate":{"type":["boolean","null"]},"storyPointEstimation":{"type":["integer","null"]},"timeEstimation":{"type":["integer","null"]},"dealSizeEstimation":{"type":["integer","null"]},"messageProvider":{"type":["string","null"]},"scheduledOn":{"type":["string","null"]},"previouslyScheduledOn":{"type":["string","null"]},"plannedWeek":{"type":["string","null"]},"plannedMonth":{"type":["string","null"]},"snoozeUntil":{"type":["string","null"],"format":"date-time"},"isRecurring":{"type":["boolean","null"]},"workspaceType":{"type":["string","null"]},"files":{"type":"array","items":{"$ref":"#/components/schemas/MediaObject"}},"messages":{"type":"array","items":{"type":"null"}},"conversationItems":{"type":"array","items":{"type":"string","format":"iri-reference"}},"people":{"type":"array","items":{"type":"string","format":"iri-reference"}},"organizations":{"type":"array","items":{"type":"string","format":"iri-reference"}},"recurringSettings":{"type":"array","items":{"type":"null"}},"automation":{"type":["string","null"],"format":"iri-reference"},"startDate":{"type":["string","null"],"format":"date-time"},"blockedFields":{"type":"array","items":{"type":"null"}}}},"MediaObject":{"type":"object","required":["file"],"properties":{"file":{"writeOnly":true,"type":["string","null"],"format":"binary"},"id":{"type":["string","null"]},"createdAt":{"type":["string","null"],"format":"date-time"},"name":{"type":["string","null"]},"size":{"type":["integer","null"]},"mimeType":{"type":["string","null"]},"contentId":{"type":["string","null"]},"updatedAt":{"type":["string","null"],"format":"date-time"},"publicUrl":{"type":["string","null"]}}},"Error.jsonld":{"allOf":[{"$ref":"#/components/schemas/HydraItemBaseSchema"},{"type":"object","properties":{"title":{"readOnly":true,"description":"A short, human-readable summary of the problem.","type":["string","null"]},"detail":{"readOnly":true,"description":"A human-readable explanation specific to this occurrence of the problem.","type":["string","null"]},"status":{"type":"number","default":400},"instance":{"readOnly":true,"description":"A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.","type":["string","null"]},"type":{"readOnly":true,"description":"A URI reference that identifies the problem type","type":"string"},"description":{"readOnly":true,"type":["string","null"]}}}],"description":"A representation of common errors."},"Error":{"type":"object","description":"A representation of common errors.","properties":{"title":{"readOnly":true,"description":"A short, human-readable summary of the problem.","type":["string","null"]},"detail":{"readOnly":true,"description":"A human-readable explanation specific to this occurrence of the problem.","type":["string","null"]},"status":{"type":"number","default":400},"instance":{"readOnly":true,"description":"A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.","type":["string","null"]},"type":{"readOnly":true,"description":"A URI reference that identifies the problem type","type":"string"}}}}},"paths":{"/tasks/{id}":{"get":{"operationId":"api_tasks_id_get","tags":["Task"],"responses":{"200":{"description":"Task resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/Task.jsonld"}},"application/json":{"schema":{"$ref":"#/components/schemas/Task"}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/Error.jsonld"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}},"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"links":{}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/Error.jsonld"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}},"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"links":{}}},"summary":"Retrieves a Task resource.","description":"Retrieves a Task resource.","parameters":[{"name":"id","in":"path","description":"Task identifier","required":true,"deprecated":false,"schema":{"type":"string"},"style":"simple","explode":false}]}}}}
```

## Retrieves a TaskCommentResource resource.

> Retrieves a TaskCommentResource resource.

```json
{"openapi":"3.1.0","info":{"title":"RogerRoger API","version":"1.0.0"},"tags":[{"name":"Tasks","description":"Resource 'Tasks' operations."}],"servers":[{"url":"https://api.rogerroger.io","description":"API"}],"security":[{"BearerAuth":[]},{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","description":"Your API key, available from the dashboard","name":"X-API-KEY","in":"header"}},"schemas":{"TaskCommentResource.jsonld":{"allOf":[{"$ref":"#/components/schemas/HydraItemBaseSchema"},{"type":"object","properties":{"id":{"type":["string","null"]},"taskId":{"writeOnly":true,"type":["string","null"]},"createdAt":{"type":["string","null"],"format":"date-time"},"description":{"type":["string","null"]},"flagged":{"type":["boolean","null"]},"author":{"type":["string","null"],"format":"iri-reference"},"mentions":{"type":"array","items":{"type":"string","format":"iri-reference"}}},"required":["description"]}]},"HydraItemBaseSchema":{"type":"object","properties":{"@context":{"oneOf":[{"type":"string"},{"type":"object","properties":{"@vocab":{"type":"string"},"hydra":{"type":"string","enum":["http://www.w3.org/ns/hydra/core#"]}},"required":["@vocab","hydra"],"additionalProperties":true}]},"@id":{"type":"string"},"@type":{"type":"string"}},"required":["@id","@type"]},"TaskCommentResource":{"type":"object","properties":{"id":{"type":["string","null"]},"taskId":{"writeOnly":true,"type":["string","null"]},"createdAt":{"type":["string","null"],"format":"date-time"},"description":{"type":["string","null"]},"flagged":{"type":["boolean","null"]},"author":{"type":["string","null"],"format":"iri-reference"},"mentions":{"type":"array","items":{"type":"string","format":"iri-reference"}}},"required":["description"]},"Error.jsonld":{"allOf":[{"$ref":"#/components/schemas/HydraItemBaseSchema"},{"type":"object","properties":{"title":{"readOnly":true,"description":"A short, human-readable summary of the problem.","type":["string","null"]},"detail":{"readOnly":true,"description":"A human-readable explanation specific to this occurrence of the problem.","type":["string","null"]},"status":{"type":"number","default":400},"instance":{"readOnly":true,"description":"A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.","type":["string","null"]},"type":{"readOnly":true,"description":"A URI reference that identifies the problem type","type":"string"},"description":{"readOnly":true,"type":["string","null"]}}}],"description":"A representation of common errors."},"Error":{"type":"object","description":"A representation of common errors.","properties":{"title":{"readOnly":true,"description":"A short, human-readable summary of the problem.","type":["string","null"]},"detail":{"readOnly":true,"description":"A human-readable explanation specific to this occurrence of the problem.","type":["string","null"]},"status":{"type":"number","default":400},"instance":{"readOnly":true,"description":"A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.","type":["string","null"]},"type":{"readOnly":true,"description":"A URI reference that identifies the problem type","type":"string"}}}}},"paths":{"/tasks/{taskId}/comments/{id}":{"get":{"operationId":"api_tasks_taskIdcomments_id_get","tags":["Tasks"],"responses":{"200":{"description":"TaskCommentResource resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/TaskCommentResource.jsonld"}},"application/json":{"schema":{"$ref":"#/components/schemas/TaskCommentResource"}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/Error.jsonld"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}},"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"links":{}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/Error.jsonld"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}},"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"links":{}}},"summary":"Retrieves a TaskCommentResource resource.","description":"Retrieves a TaskCommentResource resource.","parameters":[{"name":"taskId","in":"path","description":"TaskCommentResource identifier","required":true,"deprecated":false,"schema":{"type":"string"},"style":"simple","explode":false},{"name":"id","in":"path","description":"TaskCommentResource identifier","required":true,"deprecated":false,"schema":{"type":"string"},"style":"simple","explode":false}]}}}}
```

## Updates the TaskCommentResource resource.

> Updates the TaskCommentResource resource.

```json
{"openapi":"3.1.0","info":{"title":"RogerRoger API","version":"1.0.0"},"tags":[{"name":"Tasks","description":"Resource 'Tasks' operations."}],"servers":[{"url":"https://api.rogerroger.io","description":"API"}],"security":[{"BearerAuth":[]},{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","description":"Your API key, available from the dashboard","name":"X-API-KEY","in":"header"}},"schemas":{"TaskCommentResource.jsonld":{"allOf":[{"$ref":"#/components/schemas/HydraItemBaseSchema"},{"type":"object","properties":{"id":{"type":["string","null"]},"taskId":{"writeOnly":true,"type":["string","null"]},"createdAt":{"type":["string","null"],"format":"date-time"},"description":{"type":["string","null"]},"flagged":{"type":["boolean","null"]},"author":{"type":["string","null"],"format":"iri-reference"},"mentions":{"type":"array","items":{"type":"string","format":"iri-reference"}}},"required":["description"]}]},"HydraItemBaseSchema":{"type":"object","properties":{"@context":{"oneOf":[{"type":"string"},{"type":"object","properties":{"@vocab":{"type":"string"},"hydra":{"type":"string","enum":["http://www.w3.org/ns/hydra/core#"]}},"required":["@vocab","hydra"],"additionalProperties":true}]},"@id":{"type":"string"},"@type":{"type":"string"}},"required":["@id","@type"]},"TaskCommentResource":{"type":"object","properties":{"id":{"type":["string","null"]},"taskId":{"writeOnly":true,"type":["string","null"]},"createdAt":{"type":["string","null"],"format":"date-time"},"description":{"type":["string","null"]},"flagged":{"type":["boolean","null"]},"author":{"type":["string","null"],"format":"iri-reference"},"mentions":{"type":"array","items":{"type":"string","format":"iri-reference"}}},"required":["description"]},"Error.jsonld":{"allOf":[{"$ref":"#/components/schemas/HydraItemBaseSchema"},{"type":"object","properties":{"title":{"readOnly":true,"description":"A short, human-readable summary of the problem.","type":["string","null"]},"detail":{"readOnly":true,"description":"A human-readable explanation specific to this occurrence of the problem.","type":["string","null"]},"status":{"type":"number","default":400},"instance":{"readOnly":true,"description":"A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.","type":["string","null"]},"type":{"readOnly":true,"description":"A URI reference that identifies the problem type","type":"string"},"description":{"readOnly":true,"type":["string","null"]}}}],"description":"A representation of common errors."},"Error":{"type":"object","description":"A representation of common errors.","properties":{"title":{"readOnly":true,"description":"A short, human-readable summary of the problem.","type":["string","null"]},"detail":{"readOnly":true,"description":"A human-readable explanation specific to this occurrence of the problem.","type":["string","null"]},"status":{"type":"number","default":400},"instance":{"readOnly":true,"description":"A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.","type":["string","null"]},"type":{"readOnly":true,"description":"A URI reference that identifies the problem type","type":"string"}}},"ConstraintViolation.jsonld":{"allOf":[{"$ref":"#/components/schemas/HydraItemBaseSchema"},{"type":"object","properties":{"status":{"default":422,"type":"integer"},"violations":{"type":"array","items":{"type":"object","properties":{"propertyPath":{"type":"string","description":"The property path of the violation"},"message":{"type":"string","description":"The message associated with the violation"}}}},"detail":{"readOnly":true,"type":"string"},"description":{"readOnly":true,"type":"string"},"type":{"readOnly":true,"type":"string"},"title":{"readOnly":true,"type":["string","null"]},"instance":{"readOnly":true,"type":["string","null"]}}}],"description":"Unprocessable entity"},"ConstraintViolation":{"type":"object","description":"Unprocessable entity","properties":{"status":{"default":422,"type":"integer"},"violations":{"type":"array","items":{"type":"object","properties":{"propertyPath":{"type":"string","description":"The property path of the violation"},"message":{"type":"string","description":"The message associated with the violation"}}}},"detail":{"readOnly":true,"type":"string"},"type":{"readOnly":true,"type":"string"},"title":{"readOnly":true,"type":["string","null"]},"instance":{"readOnly":true,"type":["string","null"]}}},"TaskCommentResource.jsonMergePatch":{"type":"object","properties":{"id":{"type":["string","null"]},"taskId":{"writeOnly":true,"type":["string","null"]},"createdAt":{"type":["string","null"],"format":"date-time"},"description":{"type":["string","null"]},"flagged":{"type":["boolean","null"]},"author":{"type":["string","null"],"format":"iri-reference"},"mentions":{"type":"array","items":{"type":"string","format":"iri-reference"}}}}}},"paths":{"/tasks/{taskId}/comments/{id}":{"patch":{"operationId":"api_tasks_taskIdcomments_id_patch","tags":["Tasks"],"responses":{"200":{"description":"TaskCommentResource resource updated","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/TaskCommentResource.jsonld"}},"application/json":{"schema":{"$ref":"#/components/schemas/TaskCommentResource"}}},"links":{}},"400":{"description":"Invalid input","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/Error.jsonld"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}},"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"links":{}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/Error.jsonld"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}},"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"links":{}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/Error.jsonld"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}},"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"links":{}},"422":{"description":"An error occurred","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/ConstraintViolation.jsonld"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/ConstraintViolation"}},"application/json":{"schema":{"$ref":"#/components/schemas/ConstraintViolation"}}},"links":{}}},"summary":"Updates the TaskCommentResource resource.","description":"Updates the TaskCommentResource resource.","parameters":[{"name":"taskId","in":"path","description":"TaskCommentResource identifier","required":true,"deprecated":false,"schema":{"type":"string"},"style":"simple","explode":false},{"name":"id","in":"path","description":"TaskCommentResource identifier","required":true,"deprecated":false,"schema":{"type":"string"},"style":"simple","explode":false}],"requestBody":{"description":"The updated TaskCommentResource resource","content":{"application/merge-patch+json":{"schema":{"$ref":"#/components/schemas/TaskCommentResource.jsonMergePatch"}}},"required":true}}}}}
```

## Retrieves a TaskHistory resource.

> Retrieves a TaskHistory resource.

```json
{"openapi":"3.1.0","info":{"title":"RogerRoger API","version":"1.0.0"},"tags":[{"name":"Tasks","description":"Resource 'Tasks' operations."}],"servers":[{"url":"https://api.rogerroger.io","description":"API"}],"security":[{"BearerAuth":[]},{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","description":"Your API key, available from the dashboard","name":"X-API-KEY","in":"header"}},"schemas":{"TaskHistory.jsonld":{"allOf":[{"$ref":"#/components/schemas/HydraItemBaseSchema"},{"type":"object","properties":{"id":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"changes":{"type":"array","items":{"type":"null"}},"author":{"type":"string","format":"iri-reference"}}}]},"HydraItemBaseSchema":{"type":"object","properties":{"@context":{"oneOf":[{"type":"string"},{"type":"object","properties":{"@vocab":{"type":"string"},"hydra":{"type":"string","enum":["http://www.w3.org/ns/hydra/core#"]}},"required":["@vocab","hydra"],"additionalProperties":true}]},"@id":{"type":"string"},"@type":{"type":"string"}},"required":["@id","@type"]},"TaskHistory":{"type":"object","properties":{"id":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"changes":{"type":"array","items":{"type":"null"}},"author":{"type":"string","format":"iri-reference"}}},"Error.jsonld":{"allOf":[{"$ref":"#/components/schemas/HydraItemBaseSchema"},{"type":"object","properties":{"title":{"readOnly":true,"description":"A short, human-readable summary of the problem.","type":["string","null"]},"detail":{"readOnly":true,"description":"A human-readable explanation specific to this occurrence of the problem.","type":["string","null"]},"status":{"type":"number","default":400},"instance":{"readOnly":true,"description":"A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.","type":["string","null"]},"type":{"readOnly":true,"description":"A URI reference that identifies the problem type","type":"string"},"description":{"readOnly":true,"type":["string","null"]}}}],"description":"A representation of common errors."},"Error":{"type":"object","description":"A representation of common errors.","properties":{"title":{"readOnly":true,"description":"A short, human-readable summary of the problem.","type":["string","null"]},"detail":{"readOnly":true,"description":"A human-readable explanation specific to this occurrence of the problem.","type":["string","null"]},"status":{"type":"number","default":400},"instance":{"readOnly":true,"description":"A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.","type":["string","null"]},"type":{"readOnly":true,"description":"A URI reference that identifies the problem type","type":"string"}}}}},"paths":{"/tasks/{taskId}/history/{id}":{"get":{"operationId":"api_tasks_taskIdhistory_id_get","tags":["Tasks"],"responses":{"200":{"description":"TaskHistory resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/TaskHistory.jsonld"}},"application/json":{"schema":{"$ref":"#/components/schemas/TaskHistory"}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/Error.jsonld"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}},"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"links":{}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/Error.jsonld"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}},"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"links":{}}},"summary":"Retrieves a TaskHistory resource.","description":"Retrieves a TaskHistory resource.","parameters":[{"name":"taskId","in":"path","description":"TaskHistory identifier","required":true,"deprecated":false,"schema":{"type":"string"},"style":"simple","explode":false},{"name":"id","in":"path","description":"TaskHistory identifier","required":true,"deprecated":false,"schema":{"type":"string"},"style":"simple","explode":false}]}}}}
```

## Replaces the TaskCommentResource resource.

> Replaces the TaskCommentResource resource.

```json
{"openapi":"3.1.0","info":{"title":"RogerRoger API","version":"1.0.0"},"tags":[{"name":"Tasks","description":"Resource 'Tasks' operations."}],"servers":[{"url":"https://api.rogerroger.io","description":"API"}],"security":[{"BearerAuth":[]},{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","description":"Your API key, available from the dashboard","name":"X-API-KEY","in":"header"}},"schemas":{"TaskCommentResource.jsonld":{"allOf":[{"$ref":"#/components/schemas/HydraItemBaseSchema"},{"type":"object","properties":{"id":{"type":["string","null"]},"taskId":{"writeOnly":true,"type":["string","null"]},"createdAt":{"type":["string","null"],"format":"date-time"},"description":{"type":["string","null"]},"flagged":{"type":["boolean","null"]},"author":{"type":["string","null"],"format":"iri-reference"},"mentions":{"type":"array","items":{"type":"string","format":"iri-reference"}}},"required":["description"]}]},"HydraItemBaseSchema":{"type":"object","properties":{"@context":{"oneOf":[{"type":"string"},{"type":"object","properties":{"@vocab":{"type":"string"},"hydra":{"type":"string","enum":["http://www.w3.org/ns/hydra/core#"]}},"required":["@vocab","hydra"],"additionalProperties":true}]},"@id":{"type":"string"},"@type":{"type":"string"}},"required":["@id","@type"]},"TaskCommentResource":{"type":"object","properties":{"id":{"type":["string","null"]},"taskId":{"writeOnly":true,"type":["string","null"]},"createdAt":{"type":["string","null"],"format":"date-time"},"description":{"type":["string","null"]},"flagged":{"type":["boolean","null"]},"author":{"type":["string","null"],"format":"iri-reference"},"mentions":{"type":"array","items":{"type":"string","format":"iri-reference"}}},"required":["description"]},"Error.jsonld":{"allOf":[{"$ref":"#/components/schemas/HydraItemBaseSchema"},{"type":"object","properties":{"title":{"readOnly":true,"description":"A short, human-readable summary of the problem.","type":["string","null"]},"detail":{"readOnly":true,"description":"A human-readable explanation specific to this occurrence of the problem.","type":["string","null"]},"status":{"type":"number","default":400},"instance":{"readOnly":true,"description":"A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.","type":["string","null"]},"type":{"readOnly":true,"description":"A URI reference that identifies the problem type","type":"string"},"description":{"readOnly":true,"type":["string","null"]}}}],"description":"A representation of common errors."},"Error":{"type":"object","description":"A representation of common errors.","properties":{"title":{"readOnly":true,"description":"A short, human-readable summary of the problem.","type":["string","null"]},"detail":{"readOnly":true,"description":"A human-readable explanation specific to this occurrence of the problem.","type":["string","null"]},"status":{"type":"number","default":400},"instance":{"readOnly":true,"description":"A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.","type":["string","null"]},"type":{"readOnly":true,"description":"A URI reference that identifies the problem type","type":"string"}}},"ConstraintViolation.jsonld":{"allOf":[{"$ref":"#/components/schemas/HydraItemBaseSchema"},{"type":"object","properties":{"status":{"default":422,"type":"integer"},"violations":{"type":"array","items":{"type":"object","properties":{"propertyPath":{"type":"string","description":"The property path of the violation"},"message":{"type":"string","description":"The message associated with the violation"}}}},"detail":{"readOnly":true,"type":"string"},"description":{"readOnly":true,"type":"string"},"type":{"readOnly":true,"type":"string"},"title":{"readOnly":true,"type":["string","null"]},"instance":{"readOnly":true,"type":["string","null"]}}}],"description":"Unprocessable entity"},"ConstraintViolation":{"type":"object","description":"Unprocessable entity","properties":{"status":{"default":422,"type":"integer"},"violations":{"type":"array","items":{"type":"object","properties":{"propertyPath":{"type":"string","description":"The property path of the violation"},"message":{"type":"string","description":"The message associated with the violation"}}}},"detail":{"readOnly":true,"type":"string"},"type":{"readOnly":true,"type":"string"},"title":{"readOnly":true,"type":["string","null"]},"instance":{"readOnly":true,"type":["string","null"]}}}}},"paths":{"/tasks/{taskId}/comments/{id}":{"put":{"operationId":"api_tasks_taskIdcomments_id_put","tags":["Tasks"],"responses":{"200":{"description":"TaskCommentResource resource updated","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/TaskCommentResource.jsonld"}},"application/json":{"schema":{"$ref":"#/components/schemas/TaskCommentResource"}}},"links":{}},"400":{"description":"Invalid input","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/Error.jsonld"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}},"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"links":{}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/Error.jsonld"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}},"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"links":{}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/Error.jsonld"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}},"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"links":{}},"422":{"description":"An error occurred","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/ConstraintViolation.jsonld"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/ConstraintViolation"}},"application/json":{"schema":{"$ref":"#/components/schemas/ConstraintViolation"}}},"links":{}}},"summary":"Replaces the TaskCommentResource resource.","description":"Replaces the TaskCommentResource resource.","parameters":[{"name":"taskId","in":"path","description":"TaskCommentResource identifier","required":true,"deprecated":false,"schema":{"type":"string"},"style":"simple","explode":false},{"name":"id","in":"path","description":"TaskCommentResource identifier","required":true,"deprecated":false,"schema":{"type":"string"},"style":"simple","explode":false}],"requestBody":{"description":"The updated TaskCommentResource resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/TaskCommentResource"}},"application/json":{"schema":{"$ref":"#/components/schemas/TaskCommentResource"}}},"required":true}}}}}
```

## Updates the UpdateTaskResource resource.

> Updates the UpdateTaskResource resource.

```json
{"openapi":"3.1.0","info":{"title":"RogerRoger API","version":"1.0.0"},"tags":[{"name":"Tasks","description":"Resource 'Tasks' operations."}],"servers":[{"url":"https://api.rogerroger.io","description":"API"}],"security":[{"BearerAuth":[]},{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","description":"Your API key, available from the dashboard","name":"X-API-KEY","in":"header"}},"schemas":{"UpdateTaskResource.jsonld":{"allOf":[{"$ref":"#/components/schemas/HydraItemBaseSchema"},{"type":"object","properties":{"completedAt":{"description":"Task is completed at","type":["string","null"],"format":"date-time"},"files":{"type":"array","items":{"type":"string","format":"iri-reference"}},"recurringSettings":{"anyOf":[{"$ref":"#/components/schemas/TaskRecurringSettingsInput.jsonld"},{"type":"null"}]},"id":{"type":["string","null"]},"title":{"description":"Title of task","type":["string","null"]},"description":{"description":"Short description of task","type":["string","null"]},"status":{"description":"Workspace","type":["string","null"],"format":"iri-reference"},"author":{"description":"Author of this task","type":["string","null"],"format":"iri-reference"},"assignees":{"description":"Assignees belonging to this task","type":"array","items":{"type":"string","format":"iri-reference"}},"observers":{"description":"Obersers belonging to this task","type":"array","items":{"type":"string","format":"iri-reference"}},"tags":{"description":"Tags of this task","type":"array","items":{"type":"string","format":"iri-reference"}},"people":{"description":"People belonging to this task","type":"array","items":{"type":"string","format":"iri-reference"}},"organizations":{"description":"Organizations belonging to this task","type":"array","items":{"type":"string","format":"iri-reference"}},"messages":{"description":"Messages belonging to this task","type":"array","items":{"type":"string","format":"iri-reference"}},"conversationItems":{"description":"Messages belonging to this task","type":"array","items":{"type":"string","format":"iri-reference"}},"isFlagged":{"description":"Highlight this task","default":false,"type":"boolean"},"archivedAt":{"description":"Archive task","type":["string","null"],"format":"date-time"},"dueDate":{"description":"Date when this task is due","type":["string","null"],"format":"date-time"},"isTemplate":{"description":"Task is a template","default":false,"type":"boolean"},"storyPointEstimation":{"type":["integer","null"]},"dealSizeEstimation":{"type":["integer","null"]},"timeEstimation":{"maximum":4294967295,"type":["integer","null"]},"scheduledOn":{"description":"Date when task is scheduled","type":["string","null"],"format":"date-time"},"plannedWeek":{"description":"Date when task is planned in week","type":["string","null"],"format":"date-time"},"plannedMonth":{"description":"Date when task is planned in month","type":["string","null"],"format":"date-time"},"snoozeUntil":{"description":"Snooze task until","type":["string","null"],"format":"date-time"}},"required":["title"]}]},"HydraItemBaseSchema":{"type":"object","properties":{"@context":{"oneOf":[{"type":"string"},{"type":"object","properties":{"@vocab":{"type":"string"},"hydra":{"type":"string","enum":["http://www.w3.org/ns/hydra/core#"]}},"required":["@vocab","hydra"],"additionalProperties":true}]},"@id":{"type":"string"},"@type":{"type":"string"}},"required":["@id","@type"]},"TaskRecurringSettingsInput.jsonld":{"type":"object","properties":{"rrule":{"type":["string","null"]},"recurUntilCount":{"default":0,"type":"integer"},"recurUntil":{"type":["string","null"],"format":"date-time"},"recurOnSchedule":{"default":false,"type":"boolean"},"createNewTask":{"default":false,"type":"boolean"},"snooze":{"default":false,"type":"boolean"},"recurData":{"type":"array","items":{"type":"null"}}}},"UpdateTaskResource":{"type":"object","properties":{"completedAt":{"description":"Task is completed at","type":["string","null"],"format":"date-time"},"files":{"type":"array","items":{"type":"string","format":"iri-reference"}},"recurringSettings":{"anyOf":[{"$ref":"#/components/schemas/TaskRecurringSettingsInput"},{"type":"null"}]},"id":{"type":["string","null"]},"title":{"description":"Title of task","type":["string","null"]},"description":{"description":"Short description of task","type":["string","null"]},"status":{"description":"Workspace","type":["string","null"],"format":"iri-reference"},"author":{"description":"Author of this task","type":["string","null"],"format":"iri-reference"},"assignees":{"description":"Assignees belonging to this task","type":"array","items":{"type":"string","format":"iri-reference"}},"observers":{"description":"Obersers belonging to this task","type":"array","items":{"type":"string","format":"iri-reference"}},"tags":{"description":"Tags of this task","type":"array","items":{"type":"string","format":"iri-reference"}},"people":{"description":"People belonging to this task","type":"array","items":{"type":"string","format":"iri-reference"}},"organizations":{"description":"Organizations belonging to this task","type":"array","items":{"type":"string","format":"iri-reference"}},"messages":{"description":"Messages belonging to this task","type":"array","items":{"type":"string","format":"iri-reference"}},"conversationItems":{"description":"Messages belonging to this task","type":"array","items":{"type":"string","format":"iri-reference"}},"isFlagged":{"description":"Highlight this task","default":false,"type":"boolean"},"archivedAt":{"description":"Archive task","type":["string","null"],"format":"date-time"},"dueDate":{"description":"Date when this task is due","type":["string","null"],"format":"date-time"},"isTemplate":{"description":"Task is a template","default":false,"type":"boolean"},"storyPointEstimation":{"type":["integer","null"]},"dealSizeEstimation":{"type":["integer","null"]},"timeEstimation":{"maximum":4294967295,"type":["integer","null"]},"scheduledOn":{"description":"Date when task is scheduled","type":["string","null"],"format":"date-time"},"plannedWeek":{"description":"Date when task is planned in week","type":["string","null"],"format":"date-time"},"plannedMonth":{"description":"Date when task is planned in month","type":["string","null"],"format":"date-time"},"snoozeUntil":{"description":"Snooze task until","type":["string","null"],"format":"date-time"}},"required":["title"]},"TaskRecurringSettingsInput":{"type":"object","properties":{"rrule":{"type":["string","null"]},"recurUntilCount":{"default":0,"type":"integer"},"recurUntil":{"type":["string","null"],"format":"date-time"},"recurOnSchedule":{"default":false,"type":"boolean"},"createNewTask":{"default":false,"type":"boolean"},"snooze":{"default":false,"type":"boolean"},"recurData":{"type":"array","items":{"type":"null"}}}},"Error.jsonld":{"allOf":[{"$ref":"#/components/schemas/HydraItemBaseSchema"},{"type":"object","properties":{"title":{"readOnly":true,"description":"A short, human-readable summary of the problem.","type":["string","null"]},"detail":{"readOnly":true,"description":"A human-readable explanation specific to this occurrence of the problem.","type":["string","null"]},"status":{"type":"number","default":400},"instance":{"readOnly":true,"description":"A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.","type":["string","null"]},"type":{"readOnly":true,"description":"A URI reference that identifies the problem type","type":"string"},"description":{"readOnly":true,"type":["string","null"]}}}],"description":"A representation of common errors."},"Error":{"type":"object","description":"A representation of common errors.","properties":{"title":{"readOnly":true,"description":"A short, human-readable summary of the problem.","type":["string","null"]},"detail":{"readOnly":true,"description":"A human-readable explanation specific to this occurrence of the problem.","type":["string","null"]},"status":{"type":"number","default":400},"instance":{"readOnly":true,"description":"A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.","type":["string","null"]},"type":{"readOnly":true,"description":"A URI reference that identifies the problem type","type":"string"}}},"ConstraintViolation.jsonld":{"allOf":[{"$ref":"#/components/schemas/HydraItemBaseSchema"},{"type":"object","properties":{"status":{"default":422,"type":"integer"},"violations":{"type":"array","items":{"type":"object","properties":{"propertyPath":{"type":"string","description":"The property path of the violation"},"message":{"type":"string","description":"The message associated with the violation"}}}},"detail":{"readOnly":true,"type":"string"},"description":{"readOnly":true,"type":"string"},"type":{"readOnly":true,"type":"string"},"title":{"readOnly":true,"type":["string","null"]},"instance":{"readOnly":true,"type":["string","null"]}}}],"description":"Unprocessable entity"},"ConstraintViolation":{"type":"object","description":"Unprocessable entity","properties":{"status":{"default":422,"type":"integer"},"violations":{"type":"array","items":{"type":"object","properties":{"propertyPath":{"type":"string","description":"The property path of the violation"},"message":{"type":"string","description":"The message associated with the violation"}}}},"detail":{"readOnly":true,"type":"string"},"type":{"readOnly":true,"type":"string"},"title":{"readOnly":true,"type":["string","null"]},"instance":{"readOnly":true,"type":["string","null"]}}},"UpdateTaskResource.jsonMergePatch":{"type":"object","properties":{"completedAt":{"description":"Task is completed at","type":["string","null"],"format":"date-time"},"files":{"type":"array","items":{"type":"string","format":"iri-reference"}},"recurringSettings":{"anyOf":[{"$ref":"#/components/schemas/TaskRecurringSettingsInput"},{"type":"null"}]},"id":{"type":["string","null"]},"title":{"description":"Title of task","type":["string","null"]},"description":{"description":"Short description of task","type":["string","null"]},"status":{"description":"Workspace","type":["string","null"],"format":"iri-reference"},"author":{"description":"Author of this task","type":["string","null"],"format":"iri-reference"},"assignees":{"description":"Assignees belonging to this task","type":"array","items":{"type":"string","format":"iri-reference"}},"observers":{"description":"Obersers belonging to this task","type":"array","items":{"type":"string","format":"iri-reference"}},"tags":{"description":"Tags of this task","type":"array","items":{"type":"string","format":"iri-reference"}},"people":{"description":"People belonging to this task","type":"array","items":{"type":"string","format":"iri-reference"}},"organizations":{"description":"Organizations belonging to this task","type":"array","items":{"type":"string","format":"iri-reference"}},"messages":{"description":"Messages belonging to this task","type":"array","items":{"type":"string","format":"iri-reference"}},"conversationItems":{"description":"Messages belonging to this task","type":"array","items":{"type":"string","format":"iri-reference"}},"isFlagged":{"description":"Highlight this task","default":false,"type":"boolean"},"archivedAt":{"description":"Archive task","type":["string","null"],"format":"date-time"},"dueDate":{"description":"Date when this task is due","type":["string","null"],"format":"date-time"},"isTemplate":{"description":"Task is a template","default":false,"type":"boolean"},"storyPointEstimation":{"type":["integer","null"]},"dealSizeEstimation":{"type":["integer","null"]},"timeEstimation":{"maximum":4294967295,"type":["integer","null"]},"scheduledOn":{"description":"Date when task is scheduled","type":["string","null"],"format":"date-time"},"plannedWeek":{"description":"Date when task is planned in week","type":["string","null"],"format":"date-time"},"plannedMonth":{"description":"Date when task is planned in month","type":["string","null"],"format":"date-time"},"snoozeUntil":{"description":"Snooze task until","type":["string","null"],"format":"date-time"}}}}},"paths":{"/tasks/{id}":{"patch":{"operationId":"api_tasks_id_patch","tags":["Tasks"],"responses":{"200":{"description":"UpdateTaskResource resource updated","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UpdateTaskResource.jsonld"}},"application/json":{"schema":{"$ref":"#/components/schemas/UpdateTaskResource"}}},"links":{}},"400":{"description":"Invalid input","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/Error.jsonld"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}},"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"links":{}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/Error.jsonld"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}},"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"links":{}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/Error.jsonld"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}},"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"links":{}},"422":{"description":"An error occurred","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/ConstraintViolation.jsonld"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/ConstraintViolation"}},"application/json":{"schema":{"$ref":"#/components/schemas/ConstraintViolation"}}},"links":{}}},"summary":"Updates the UpdateTaskResource resource.","description":"Updates the UpdateTaskResource resource.","parameters":[{"name":"id","in":"path","description":"UpdateTaskResource identifier","required":true,"deprecated":false,"schema":{"type":"string"},"style":"simple","explode":false}],"requestBody":{"description":"The updated UpdateTaskResource resource","content":{"application/merge-patch+json":{"schema":{"$ref":"#/components/schemas/UpdateTaskResource.jsonMergePatch"}}},"required":true}}}}}
```

## Replaces the UpdateTaskResource resource.

> Replaces the UpdateTaskResource resource.

```json
{"openapi":"3.1.0","info":{"title":"RogerRoger API","version":"1.0.0"},"tags":[{"name":"Tasks","description":"Resource 'Tasks' operations."}],"servers":[{"url":"https://api.rogerroger.io","description":"API"}],"security":[{"BearerAuth":[]},{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","description":"Your API key, available from the dashboard","name":"X-API-KEY","in":"header"}},"schemas":{"UpdateTaskResource.jsonld":{"allOf":[{"$ref":"#/components/schemas/HydraItemBaseSchema"},{"type":"object","properties":{"completedAt":{"description":"Task is completed at","type":["string","null"],"format":"date-time"},"files":{"type":"array","items":{"type":"string","format":"iri-reference"}},"recurringSettings":{"anyOf":[{"$ref":"#/components/schemas/TaskRecurringSettingsInput.jsonld"},{"type":"null"}]},"id":{"type":["string","null"]},"title":{"description":"Title of task","type":["string","null"]},"description":{"description":"Short description of task","type":["string","null"]},"status":{"description":"Workspace","type":["string","null"],"format":"iri-reference"},"author":{"description":"Author of this task","type":["string","null"],"format":"iri-reference"},"assignees":{"description":"Assignees belonging to this task","type":"array","items":{"type":"string","format":"iri-reference"}},"observers":{"description":"Obersers belonging to this task","type":"array","items":{"type":"string","format":"iri-reference"}},"tags":{"description":"Tags of this task","type":"array","items":{"type":"string","format":"iri-reference"}},"people":{"description":"People belonging to this task","type":"array","items":{"type":"string","format":"iri-reference"}},"organizations":{"description":"Organizations belonging to this task","type":"array","items":{"type":"string","format":"iri-reference"}},"messages":{"description":"Messages belonging to this task","type":"array","items":{"type":"string","format":"iri-reference"}},"conversationItems":{"description":"Messages belonging to this task","type":"array","items":{"type":"string","format":"iri-reference"}},"isFlagged":{"description":"Highlight this task","default":false,"type":"boolean"},"archivedAt":{"description":"Archive task","type":["string","null"],"format":"date-time"},"dueDate":{"description":"Date when this task is due","type":["string","null"],"format":"date-time"},"isTemplate":{"description":"Task is a template","default":false,"type":"boolean"},"storyPointEstimation":{"type":["integer","null"]},"dealSizeEstimation":{"type":["integer","null"]},"timeEstimation":{"maximum":4294967295,"type":["integer","null"]},"scheduledOn":{"description":"Date when task is scheduled","type":["string","null"],"format":"date-time"},"plannedWeek":{"description":"Date when task is planned in week","type":["string","null"],"format":"date-time"},"plannedMonth":{"description":"Date when task is planned in month","type":["string","null"],"format":"date-time"},"snoozeUntil":{"description":"Snooze task until","type":["string","null"],"format":"date-time"}},"required":["title"]}]},"HydraItemBaseSchema":{"type":"object","properties":{"@context":{"oneOf":[{"type":"string"},{"type":"object","properties":{"@vocab":{"type":"string"},"hydra":{"type":"string","enum":["http://www.w3.org/ns/hydra/core#"]}},"required":["@vocab","hydra"],"additionalProperties":true}]},"@id":{"type":"string"},"@type":{"type":"string"}},"required":["@id","@type"]},"TaskRecurringSettingsInput.jsonld":{"type":"object","properties":{"rrule":{"type":["string","null"]},"recurUntilCount":{"default":0,"type":"integer"},"recurUntil":{"type":["string","null"],"format":"date-time"},"recurOnSchedule":{"default":false,"type":"boolean"},"createNewTask":{"default":false,"type":"boolean"},"snooze":{"default":false,"type":"boolean"},"recurData":{"type":"array","items":{"type":"null"}}}},"UpdateTaskResource":{"type":"object","properties":{"completedAt":{"description":"Task is completed at","type":["string","null"],"format":"date-time"},"files":{"type":"array","items":{"type":"string","format":"iri-reference"}},"recurringSettings":{"anyOf":[{"$ref":"#/components/schemas/TaskRecurringSettingsInput"},{"type":"null"}]},"id":{"type":["string","null"]},"title":{"description":"Title of task","type":["string","null"]},"description":{"description":"Short description of task","type":["string","null"]},"status":{"description":"Workspace","type":["string","null"],"format":"iri-reference"},"author":{"description":"Author of this task","type":["string","null"],"format":"iri-reference"},"assignees":{"description":"Assignees belonging to this task","type":"array","items":{"type":"string","format":"iri-reference"}},"observers":{"description":"Obersers belonging to this task","type":"array","items":{"type":"string","format":"iri-reference"}},"tags":{"description":"Tags of this task","type":"array","items":{"type":"string","format":"iri-reference"}},"people":{"description":"People belonging to this task","type":"array","items":{"type":"string","format":"iri-reference"}},"organizations":{"description":"Organizations belonging to this task","type":"array","items":{"type":"string","format":"iri-reference"}},"messages":{"description":"Messages belonging to this task","type":"array","items":{"type":"string","format":"iri-reference"}},"conversationItems":{"description":"Messages belonging to this task","type":"array","items":{"type":"string","format":"iri-reference"}},"isFlagged":{"description":"Highlight this task","default":false,"type":"boolean"},"archivedAt":{"description":"Archive task","type":["string","null"],"format":"date-time"},"dueDate":{"description":"Date when this task is due","type":["string","null"],"format":"date-time"},"isTemplate":{"description":"Task is a template","default":false,"type":"boolean"},"storyPointEstimation":{"type":["integer","null"]},"dealSizeEstimation":{"type":["integer","null"]},"timeEstimation":{"maximum":4294967295,"type":["integer","null"]},"scheduledOn":{"description":"Date when task is scheduled","type":["string","null"],"format":"date-time"},"plannedWeek":{"description":"Date when task is planned in week","type":["string","null"],"format":"date-time"},"plannedMonth":{"description":"Date when task is planned in month","type":["string","null"],"format":"date-time"},"snoozeUntil":{"description":"Snooze task until","type":["string","null"],"format":"date-time"}},"required":["title"]},"TaskRecurringSettingsInput":{"type":"object","properties":{"rrule":{"type":["string","null"]},"recurUntilCount":{"default":0,"type":"integer"},"recurUntil":{"type":["string","null"],"format":"date-time"},"recurOnSchedule":{"default":false,"type":"boolean"},"createNewTask":{"default":false,"type":"boolean"},"snooze":{"default":false,"type":"boolean"},"recurData":{"type":"array","items":{"type":"null"}}}},"Error.jsonld":{"allOf":[{"$ref":"#/components/schemas/HydraItemBaseSchema"},{"type":"object","properties":{"title":{"readOnly":true,"description":"A short, human-readable summary of the problem.","type":["string","null"]},"detail":{"readOnly":true,"description":"A human-readable explanation specific to this occurrence of the problem.","type":["string","null"]},"status":{"type":"number","default":400},"instance":{"readOnly":true,"description":"A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.","type":["string","null"]},"type":{"readOnly":true,"description":"A URI reference that identifies the problem type","type":"string"},"description":{"readOnly":true,"type":["string","null"]}}}],"description":"A representation of common errors."},"Error":{"type":"object","description":"A representation of common errors.","properties":{"title":{"readOnly":true,"description":"A short, human-readable summary of the problem.","type":["string","null"]},"detail":{"readOnly":true,"description":"A human-readable explanation specific to this occurrence of the problem.","type":["string","null"]},"status":{"type":"number","default":400},"instance":{"readOnly":true,"description":"A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.","type":["string","null"]},"type":{"readOnly":true,"description":"A URI reference that identifies the problem type","type":"string"}}},"ConstraintViolation.jsonld":{"allOf":[{"$ref":"#/components/schemas/HydraItemBaseSchema"},{"type":"object","properties":{"status":{"default":422,"type":"integer"},"violations":{"type":"array","items":{"type":"object","properties":{"propertyPath":{"type":"string","description":"The property path of the violation"},"message":{"type":"string","description":"The message associated with the violation"}}}},"detail":{"readOnly":true,"type":"string"},"description":{"readOnly":true,"type":"string"},"type":{"readOnly":true,"type":"string"},"title":{"readOnly":true,"type":["string","null"]},"instance":{"readOnly":true,"type":["string","null"]}}}],"description":"Unprocessable entity"},"ConstraintViolation":{"type":"object","description":"Unprocessable entity","properties":{"status":{"default":422,"type":"integer"},"violations":{"type":"array","items":{"type":"object","properties":{"propertyPath":{"type":"string","description":"The property path of the violation"},"message":{"type":"string","description":"The message associated with the violation"}}}},"detail":{"readOnly":true,"type":"string"},"type":{"readOnly":true,"type":"string"},"title":{"readOnly":true,"type":["string","null"]},"instance":{"readOnly":true,"type":["string","null"]}}}}},"paths":{"/tasks/{id}":{"put":{"operationId":"api_tasks_id_put","tags":["Tasks"],"responses":{"200":{"description":"UpdateTaskResource resource updated","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UpdateTaskResource.jsonld"}},"application/json":{"schema":{"$ref":"#/components/schemas/UpdateTaskResource"}}},"links":{}},"400":{"description":"Invalid input","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/Error.jsonld"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}},"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"links":{}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/Error.jsonld"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}},"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"links":{}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/Error.jsonld"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}},"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"links":{}},"422":{"description":"An error occurred","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/ConstraintViolation.jsonld"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/ConstraintViolation"}},"application/json":{"schema":{"$ref":"#/components/schemas/ConstraintViolation"}}},"links":{}}},"summary":"Replaces the UpdateTaskResource resource.","description":"Replaces the UpdateTaskResource resource.","parameters":[{"name":"id","in":"path","description":"UpdateTaskResource identifier","required":true,"deprecated":false,"schema":{"type":"string"},"style":"simple","explode":false}],"requestBody":{"description":"The updated UpdateTaskResource resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/UpdateTaskResource"}},"application/json":{"schema":{"$ref":"#/components/schemas/UpdateTaskResource"}}},"required":true}}}}}
```

## Retrieves the collection of Task resources.

> Retrieves the collection of Task resources.

```json
{"openapi":"3.1.0","info":{"title":"RogerRoger API","version":"1.0.0"},"tags":[{"name":"Task","description":"Resource 'Task' operations."}],"servers":[{"url":"https://api.rogerroger.io","description":"API"}],"security":[{"BearerAuth":[]},{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","description":"Your API key, available from the dashboard","name":"X-API-KEY","in":"header"}},"schemas":{"HydraCollectionBaseSchema":{"type":"object","required":["member"],"properties":{"member":{"type":"array","items":{"type":"object"}},"totalItems":{"type":"integer","minimum":0},"view":{"type":"object","properties":{"@id":{"type":"string","format":"iri-reference"},"@type":{"type":"string"},"first":{"type":"string","format":"iri-reference"},"last":{"type":"string","format":"iri-reference"},"previous":{"type":"string","format":"iri-reference"},"next":{"type":"string","format":"iri-reference"}}},"search":{"type":"object","properties":{"@type":{"type":"string"},"template":{"type":"string"},"variableRepresentation":{"type":"string"},"mapping":{"type":"array","items":{"type":"object","properties":{"@type":{"type":"string"},"variable":{"type":"string"},"property":{"type":["string","null"]},"required":{"type":"boolean"}}}}}}}},"Task.jsonld":{"allOf":[{"$ref":"#/components/schemas/HydraItemBaseSchema"},{"type":"object","properties":{"id":{"type":["string","null"]},"position":{"type":["integer","null"]},"totalComments":{"type":["integer","null"]},"title":{"type":["string","null"]},"description":{"type":["string","null"]},"isFlagged":{"type":["boolean","null"]},"isSubTask":{"type":["boolean","null"]},"indexNumber":{"type":["integer","null"]},"createdAt":{"type":["string","null"],"format":"date-time"},"updatedAt":{"type":["string","null"],"format":"date-time"},"completedAt":{"type":["string","null"],"format":"date-time"},"archivedAt":{"type":["string","null"],"format":"date-time"},"dueDate":{"type":["string","null"],"format":"date-time"},"workspace":{"type":["string","null"],"format":"iri-reference"},"status":{"type":["string","null"],"format":"iri-reference"},"author":{"type":["string","null"],"format":"iri-reference"},"parent":{"type":["string","null"],"format":"iri-reference"},"tags":{"type":"array","items":{"type":"string","format":"iri-reference"}},"assignees":{"type":"array","items":{"type":"string","format":"iri-reference"}},"observers":{"type":"array","items":{"type":"string","format":"iri-reference"}},"subTasks":{"anyOf":[{"type":"array","items":{"type":"string","format":"iri-reference"}},{"type":"array","items":{"type":"string","format":"iri-reference"}}]},"completedSubtasks":{"type":["integer","null"]},"totalSubtasks":{"type":["integer","null"]},"isTemplate":{"type":["boolean","null"]},"storyPointEstimation":{"type":["integer","null"]},"timeEstimation":{"type":["integer","null"]},"dealSizeEstimation":{"type":["integer","null"]},"messageProvider":{"type":["string","null"]},"scheduledOn":{"type":["string","null"]},"previouslyScheduledOn":{"type":["string","null"]},"plannedWeek":{"type":["string","null"]},"plannedMonth":{"type":["string","null"]},"snoozeUntil":{"type":["string","null"],"format":"date-time"},"isRecurring":{"type":["boolean","null"]},"workspaceType":{"type":["string","null"]},"files":{"type":"array","items":{"$ref":"#/components/schemas/MediaObject.jsonld"}},"messages":{"type":"array","items":{"type":"null"}},"conversationItems":{"type":"array","items":{"type":"string","format":"iri-reference"}},"people":{"type":"array","items":{"type":"string","format":"iri-reference"}},"organizations":{"type":"array","items":{"type":"string","format":"iri-reference"}},"recurringSettings":{"type":"array","items":{"type":"null"}},"automation":{"type":["string","null"],"format":"iri-reference"},"startDate":{"type":["string","null"],"format":"date-time"},"blockedFields":{"type":"array","items":{"type":"null"}}}}]},"HydraItemBaseSchema":{"type":"object","properties":{"@context":{"oneOf":[{"type":"string"},{"type":"object","properties":{"@vocab":{"type":"string"},"hydra":{"type":"string","enum":["http://www.w3.org/ns/hydra/core#"]}},"required":["@vocab","hydra"],"additionalProperties":true}]},"@id":{"type":"string"},"@type":{"type":"string"}},"required":["@id","@type"]},"MediaObject.jsonld":{"allOf":[{"$ref":"#/components/schemas/HydraItemBaseSchema"},{"type":"object","required":["file"],"properties":{"file":{"writeOnly":true,"type":["string","null"],"format":"binary"},"id":{"type":["string","null"]},"createdAt":{"type":["string","null"],"format":"date-time"},"name":{"type":["string","null"]},"size":{"type":["integer","null"]},"mimeType":{"type":["string","null"]},"contentId":{"type":["string","null"]},"updatedAt":{"type":["string","null"],"format":"date-time"},"publicUrl":{"type":["string","null"]}}}]},"Task":{"type":"object","properties":{"id":{"type":["string","null"]},"position":{"type":["integer","null"]},"totalComments":{"type":["integer","null"]},"title":{"type":["string","null"]},"description":{"type":["string","null"]},"isFlagged":{"type":["boolean","null"]},"isSubTask":{"type":["boolean","null"]},"indexNumber":{"type":["integer","null"]},"createdAt":{"type":["string","null"],"format":"date-time"},"updatedAt":{"type":["string","null"],"format":"date-time"},"completedAt":{"type":["string","null"],"format":"date-time"},"archivedAt":{"type":["string","null"],"format":"date-time"},"dueDate":{"type":["string","null"],"format":"date-time"},"workspace":{"type":["string","null"],"format":"iri-reference"},"status":{"type":["string","null"],"format":"iri-reference"},"author":{"type":["string","null"],"format":"iri-reference"},"parent":{"type":["string","null"],"format":"iri-reference"},"tags":{"type":"array","items":{"type":"string","format":"iri-reference"}},"assignees":{"type":"array","items":{"type":"string","format":"iri-reference"}},"observers":{"type":"array","items":{"type":"string","format":"iri-reference"}},"subTasks":{"anyOf":[{"type":"array","items":{"type":"string","format":"iri-reference"}},{"type":"array","items":{"type":"string","format":"iri-reference"}}]},"completedSubtasks":{"type":["integer","null"]},"totalSubtasks":{"type":["integer","null"]},"isTemplate":{"type":["boolean","null"]},"storyPointEstimation":{"type":["integer","null"]},"timeEstimation":{"type":["integer","null"]},"dealSizeEstimation":{"type":["integer","null"]},"messageProvider":{"type":["string","null"]},"scheduledOn":{"type":["string","null"]},"previouslyScheduledOn":{"type":["string","null"]},"plannedWeek":{"type":["string","null"]},"plannedMonth":{"type":["string","null"]},"snoozeUntil":{"type":["string","null"],"format":"date-time"},"isRecurring":{"type":["boolean","null"]},"workspaceType":{"type":["string","null"]},"files":{"type":"array","items":{"$ref":"#/components/schemas/MediaObject"}},"messages":{"type":"array","items":{"type":"null"}},"conversationItems":{"type":"array","items":{"type":"string","format":"iri-reference"}},"people":{"type":"array","items":{"type":"string","format":"iri-reference"}},"organizations":{"type":"array","items":{"type":"string","format":"iri-reference"}},"recurringSettings":{"type":"array","items":{"type":"null"}},"automation":{"type":["string","null"],"format":"iri-reference"},"startDate":{"type":["string","null"],"format":"date-time"},"blockedFields":{"type":"array","items":{"type":"null"}}}},"MediaObject":{"type":"object","required":["file"],"properties":{"file":{"writeOnly":true,"type":["string","null"],"format":"binary"},"id":{"type":["string","null"]},"createdAt":{"type":["string","null"],"format":"date-time"},"name":{"type":["string","null"]},"size":{"type":["integer","null"]},"mimeType":{"type":["string","null"]},"contentId":{"type":["string","null"]},"updatedAt":{"type":["string","null"],"format":"date-time"},"publicUrl":{"type":["string","null"]}}},"Error.jsonld":{"allOf":[{"$ref":"#/components/schemas/HydraItemBaseSchema"},{"type":"object","properties":{"title":{"readOnly":true,"description":"A short, human-readable summary of the problem.","type":["string","null"]},"detail":{"readOnly":true,"description":"A human-readable explanation specific to this occurrence of the problem.","type":["string","null"]},"status":{"type":"number","default":400},"instance":{"readOnly":true,"description":"A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.","type":["string","null"]},"type":{"readOnly":true,"description":"A URI reference that identifies the problem type","type":"string"},"description":{"readOnly":true,"type":["string","null"]}}}],"description":"A representation of common errors."},"Error":{"type":"object","description":"A representation of common errors.","properties":{"title":{"readOnly":true,"description":"A short, human-readable summary of the problem.","type":["string","null"]},"detail":{"readOnly":true,"description":"A human-readable explanation specific to this occurrence of the problem.","type":["string","null"]},"status":{"type":"number","default":400},"instance":{"readOnly":true,"description":"A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.","type":["string","null"]},"type":{"readOnly":true,"description":"A URI reference that identifies the problem type","type":"string"}}}}},"paths":{"/tasks":{"get":{"operationId":"api_tasks_get_collection","tags":["Task"],"responses":{"200":{"description":"Task collection","content":{"application/ld+json":{"schema":{"type":"object","description":"Task.jsonld collection.","allOf":[{"$ref":"#/components/schemas/HydraCollectionBaseSchema"},{"type":"object","properties":{"member":{"type":"array","items":{"$ref":"#/components/schemas/Task.jsonld"}}}}]}},"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Task"}}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/Error.jsonld"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}},"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"links":{}}},"summary":"Retrieves the collection of Task resources.","description":"Retrieves the collection of Task resources.","parameters":[{"name":"page","in":"query","description":"The collection page number","required":false,"deprecated":false,"schema":{"type":"integer","default":1},"style":"form","explode":false},{"name":"itemsPerPage","in":"query","description":"The number of items per page","required":false,"deprecated":false,"schema":{"type":"integer","default":15,"minimum":0,"maximum":30},"style":"form","explode":false},{"name":"author.id","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string"},"style":"form","explode":false},{"name":"author.id[]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"array","items":{"type":"string"}},"style":"form","explode":true},{"name":"assignees.id","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string"},"style":"form","explode":false},{"name":"assignees.id[]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"array","items":{"type":"string"}},"style":"form","explode":true},{"name":"observers.id","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string"},"style":"form","explode":false},{"name":"observers.id[]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"array","items":{"type":"string"}},"style":"form","explode":true},{"name":"workspace.uuid","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string"},"style":"form","explode":false},{"name":"workspace.uuid[]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"array","items":{"type":"string"}},"style":"form","explode":true},{"name":"status.uuid","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string"},"style":"form","explode":false},{"name":"status.uuid[]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"array","items":{"type":"string"}},"style":"form","explode":true},{"name":"message.id","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string"},"style":"form","explode":false},{"name":"message.id[]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"array","items":{"type":"string"}},"style":"form","explode":true},{"name":"tags.id","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string"},"style":"form","explode":false},{"name":"tags.id[]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"array","items":{"type":"string"}},"style":"form","explode":true},{"name":"people.personId","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string"},"style":"form","explode":false},{"name":"people.personId[]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"array","items":{"type":"string"}},"style":"form","explode":true},{"name":"organizations.organizationId","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string"},"style":"form","explode":false},{"name":"organizations.organizationId[]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"array","items":{"type":"string"}},"style":"form","explode":true},{"name":"order[position]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string","enum":["asc","desc"]},"style":"form","explode":false},{"name":"order[createdAt]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string","enum":["asc","desc"]},"style":"form","explode":false},{"name":"order[dueDate]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string","enum":["asc","desc"]},"style":"form","explode":false},{"name":"order[storyPointEstimation]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string","enum":["asc","desc"]},"style":"form","explode":false},{"name":"order[timeEstimation]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string","enum":["asc","desc"]},"style":"form","explode":false},{"name":"order[dealSizeEstimation]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string","enum":["asc","desc"]},"style":"form","explode":false},{"name":"order[scheduledOn]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string","enum":["asc","desc"]},"style":"form","explode":false},{"name":"completedAt[strictly_after]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string"},"style":"form","explode":false},{"name":"completedAt[after]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string"},"style":"form","explode":false},{"name":"completedAt[strictly_before]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string"},"style":"form","explode":false},{"name":"completedAt[before]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string"},"style":"form","explode":false},{"name":"archivedAt[strictly_after]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string"},"style":"form","explode":false},{"name":"archivedAt[after]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string"},"style":"form","explode":false},{"name":"archivedAt[strictly_before]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string"},"style":"form","explode":false},{"name":"archivedAt[before]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string"},"style":"form","explode":false},{"name":"dueDate[strictly_after]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string"},"style":"form","explode":false},{"name":"dueDate[after]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string"},"style":"form","explode":false},{"name":"dueDate[strictly_before]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string"},"style":"form","explode":false},{"name":"dueDate[before]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string"},"style":"form","explode":false},{"name":"createdAt[strictly_after]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string"},"style":"form","explode":false},{"name":"createdAt[after]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string"},"style":"form","explode":false},{"name":"createdAt[strictly_before]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string"},"style":"form","explode":false},{"name":"createdAt[before]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string"},"style":"form","explode":false},{"name":"scheduledOn[strictly_after]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string"},"style":"form","explode":false},{"name":"scheduledOn[after]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string"},"style":"form","explode":false},{"name":"scheduledOn[strictly_before]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string"},"style":"form","explode":false},{"name":"scheduledOn[before]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string"},"style":"form","explode":false},{"name":"snoozeUntil[strictly_after]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string"},"style":"form","explode":false},{"name":"snoozeUntil[after]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string"},"style":"form","explode":false},{"name":"snoozeUntil[strictly_before]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string"},"style":"form","explode":false},{"name":"snoozeUntil[before]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string"},"style":"form","explode":false},{"name":"startDate[strictly_after]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string"},"style":"form","explode":false},{"name":"startDate[after]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string"},"style":"form","explode":false},{"name":"startDate[strictly_before]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string"},"style":"form","explode":false},{"name":"startDate[before]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string"},"style":"form","explode":false},{"name":"exists[completedAt]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"boolean"},"style":"form","explode":false},{"name":"exists[archivedAt]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"boolean"},"style":"form","explode":false},{"name":"exists[snoozeUntil]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"boolean"},"style":"form","explode":false},{"name":"exists[assignees.id]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"boolean"},"style":"form","explode":false},{"name":"exists[workspace.uuid]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"boolean"},"style":"form","explode":false},{"name":"exists[message.id]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"boolean"},"style":"form","explode":false},{"name":"exists[tags.id]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"boolean"},"style":"form","explode":false},{"name":"exists[people.personId]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"boolean"},"style":"form","explode":false},{"name":"exists[organizations.organizationId]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"boolean"},"style":"form","explode":false},{"name":"exists[storyPointEstimation]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"boolean"},"style":"form","explode":false},{"name":"exists[dealSizeEstimation]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"boolean"},"style":"form","explode":false},{"name":"exists[timeEstimation]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"boolean"},"style":"form","explode":false},{"name":"q","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string"},"style":"form","explode":false},{"name":"view","in":"query","description":"Filter parameter to specify the view. To get only UUIDs, use 'idx'.","required":false,"deprecated":false,"schema":{"type":"string","enum":["idx"]},"style":"form","explode":false}]}}}}
```

## Retrieves the collection of TaskCommentResource resources.

> Retrieves the collection of TaskCommentResource resources.

```json
{"openapi":"3.1.0","info":{"title":"RogerRoger API","version":"1.0.0"},"tags":[{"name":"Tasks","description":"Resource 'Tasks' operations."}],"servers":[{"url":"https://api.rogerroger.io","description":"API"}],"security":[{"BearerAuth":[]},{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","description":"Your API key, available from the dashboard","name":"X-API-KEY","in":"header"}},"schemas":{"HydraCollectionBaseSchema":{"type":"object","required":["member"],"properties":{"member":{"type":"array","items":{"type":"object"}},"totalItems":{"type":"integer","minimum":0},"view":{"type":"object","properties":{"@id":{"type":"string","format":"iri-reference"},"@type":{"type":"string"},"first":{"type":"string","format":"iri-reference"},"last":{"type":"string","format":"iri-reference"},"previous":{"type":"string","format":"iri-reference"},"next":{"type":"string","format":"iri-reference"}}},"search":{"type":"object","properties":{"@type":{"type":"string"},"template":{"type":"string"},"variableRepresentation":{"type":"string"},"mapping":{"type":"array","items":{"type":"object","properties":{"@type":{"type":"string"},"variable":{"type":"string"},"property":{"type":["string","null"]},"required":{"type":"boolean"}}}}}}}},"TaskCommentResource.jsonld":{"allOf":[{"$ref":"#/components/schemas/HydraItemBaseSchema"},{"type":"object","properties":{"id":{"type":["string","null"]},"taskId":{"writeOnly":true,"type":["string","null"]},"createdAt":{"type":["string","null"],"format":"date-time"},"description":{"type":["string","null"]},"flagged":{"type":["boolean","null"]},"author":{"type":["string","null"],"format":"iri-reference"},"mentions":{"type":"array","items":{"type":"string","format":"iri-reference"}}},"required":["description"]}]},"HydraItemBaseSchema":{"type":"object","properties":{"@context":{"oneOf":[{"type":"string"},{"type":"object","properties":{"@vocab":{"type":"string"},"hydra":{"type":"string","enum":["http://www.w3.org/ns/hydra/core#"]}},"required":["@vocab","hydra"],"additionalProperties":true}]},"@id":{"type":"string"},"@type":{"type":"string"}},"required":["@id","@type"]},"TaskCommentResource":{"type":"object","properties":{"id":{"type":["string","null"]},"taskId":{"writeOnly":true,"type":["string","null"]},"createdAt":{"type":["string","null"],"format":"date-time"},"description":{"type":["string","null"]},"flagged":{"type":["boolean","null"]},"author":{"type":["string","null"],"format":"iri-reference"},"mentions":{"type":"array","items":{"type":"string","format":"iri-reference"}}},"required":["description"]},"Error.jsonld":{"allOf":[{"$ref":"#/components/schemas/HydraItemBaseSchema"},{"type":"object","properties":{"title":{"readOnly":true,"description":"A short, human-readable summary of the problem.","type":["string","null"]},"detail":{"readOnly":true,"description":"A human-readable explanation specific to this occurrence of the problem.","type":["string","null"]},"status":{"type":"number","default":400},"instance":{"readOnly":true,"description":"A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.","type":["string","null"]},"type":{"readOnly":true,"description":"A URI reference that identifies the problem type","type":"string"},"description":{"readOnly":true,"type":["string","null"]}}}],"description":"A representation of common errors."},"Error":{"type":"object","description":"A representation of common errors.","properties":{"title":{"readOnly":true,"description":"A short, human-readable summary of the problem.","type":["string","null"]},"detail":{"readOnly":true,"description":"A human-readable explanation specific to this occurrence of the problem.","type":["string","null"]},"status":{"type":"number","default":400},"instance":{"readOnly":true,"description":"A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.","type":["string","null"]},"type":{"readOnly":true,"description":"A URI reference that identifies the problem type","type":"string"}}}}},"paths":{"/tasks/{taskId}/comments":{"get":{"operationId":"api_tasks_taskIdcomments_get_collection","tags":["Tasks"],"responses":{"200":{"description":"TaskCommentResource collection","content":{"application/ld+json":{"schema":{"type":"object","description":"TaskCommentResource.jsonld collection.","allOf":[{"$ref":"#/components/schemas/HydraCollectionBaseSchema"},{"type":"object","properties":{"member":{"type":"array","items":{"$ref":"#/components/schemas/TaskCommentResource.jsonld"}}}}]}},"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/TaskCommentResource"}}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/Error.jsonld"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}},"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"links":{}}},"summary":"Retrieves the collection of TaskCommentResource resources.","description":"Retrieves the collection of TaskCommentResource resources.","parameters":[{"name":"taskId","in":"path","description":"TaskCommentResource identifier","required":true,"deprecated":false,"schema":{"type":"string"},"style":"simple","explode":false},{"name":"page","in":"query","description":"The collection page number","required":false,"deprecated":false,"schema":{"type":"integer","default":1},"style":"form","explode":false},{"name":"itemsPerPage","in":"query","description":"The number of items per page","required":false,"deprecated":false,"schema":{"type":"integer","default":15,"minimum":0,"maximum":30},"style":"form","explode":false},{"name":"createdAt[strictly_after]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string"},"style":"form","explode":false},{"name":"createdAt[after]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string"},"style":"form","explode":false},{"name":"createdAt[strictly_before]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string"},"style":"form","explode":false},{"name":"createdAt[before]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string"},"style":"form","explode":false},{"name":"flagged","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"boolean"},"style":"form","explode":false},{"name":"author.id","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string"},"style":"form","explode":false},{"name":"author.id[]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"array","items":{"type":"string"}},"style":"form","explode":true},{"name":"order[flagged]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string","enum":["asc","desc"]},"style":"form","explode":false},{"name":"order[createdAt]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string","enum":["asc","desc"]},"style":"form","explode":false}]}}}}
```

## Retrieves the collection of TaskHistory resources.

> Retrieves the collection of TaskHistory resources.

```json
{"openapi":"3.1.0","info":{"title":"RogerRoger API","version":"1.0.0"},"tags":[{"name":"Tasks","description":"Resource 'Tasks' operations."}],"servers":[{"url":"https://api.rogerroger.io","description":"API"}],"security":[{"BearerAuth":[]},{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","description":"Your API key, available from the dashboard","name":"X-API-KEY","in":"header"}},"schemas":{"HydraCollectionBaseSchema":{"type":"object","required":["member"],"properties":{"member":{"type":"array","items":{"type":"object"}},"totalItems":{"type":"integer","minimum":0},"view":{"type":"object","properties":{"@id":{"type":"string","format":"iri-reference"},"@type":{"type":"string"},"first":{"type":"string","format":"iri-reference"},"last":{"type":"string","format":"iri-reference"},"previous":{"type":"string","format":"iri-reference"},"next":{"type":"string","format":"iri-reference"}}},"search":{"type":"object","properties":{"@type":{"type":"string"},"template":{"type":"string"},"variableRepresentation":{"type":"string"},"mapping":{"type":"array","items":{"type":"object","properties":{"@type":{"type":"string"},"variable":{"type":"string"},"property":{"type":["string","null"]},"required":{"type":"boolean"}}}}}}}},"TaskHistory.jsonld":{"allOf":[{"$ref":"#/components/schemas/HydraItemBaseSchema"},{"type":"object","properties":{"id":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"changes":{"type":"array","items":{"type":"null"}},"author":{"type":"string","format":"iri-reference"}}}]},"HydraItemBaseSchema":{"type":"object","properties":{"@context":{"oneOf":[{"type":"string"},{"type":"object","properties":{"@vocab":{"type":"string"},"hydra":{"type":"string","enum":["http://www.w3.org/ns/hydra/core#"]}},"required":["@vocab","hydra"],"additionalProperties":true}]},"@id":{"type":"string"},"@type":{"type":"string"}},"required":["@id","@type"]},"TaskHistory":{"type":"object","properties":{"id":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"changes":{"type":"array","items":{"type":"null"}},"author":{"type":"string","format":"iri-reference"}}},"Error.jsonld":{"allOf":[{"$ref":"#/components/schemas/HydraItemBaseSchema"},{"type":"object","properties":{"title":{"readOnly":true,"description":"A short, human-readable summary of the problem.","type":["string","null"]},"detail":{"readOnly":true,"description":"A human-readable explanation specific to this occurrence of the problem.","type":["string","null"]},"status":{"type":"number","default":400},"instance":{"readOnly":true,"description":"A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.","type":["string","null"]},"type":{"readOnly":true,"description":"A URI reference that identifies the problem type","type":"string"},"description":{"readOnly":true,"type":["string","null"]}}}],"description":"A representation of common errors."},"Error":{"type":"object","description":"A representation of common errors.","properties":{"title":{"readOnly":true,"description":"A short, human-readable summary of the problem.","type":["string","null"]},"detail":{"readOnly":true,"description":"A human-readable explanation specific to this occurrence of the problem.","type":["string","null"]},"status":{"type":"number","default":400},"instance":{"readOnly":true,"description":"A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.","type":["string","null"]},"type":{"readOnly":true,"description":"A URI reference that identifies the problem type","type":"string"}}}}},"paths":{"/tasks/{taskId}/history":{"get":{"operationId":"api_tasks_taskIdhistory_get_collection","tags":["Tasks"],"responses":{"200":{"description":"TaskHistory collection","content":{"application/ld+json":{"schema":{"type":"object","description":"TaskHistory.jsonld collection.","allOf":[{"$ref":"#/components/schemas/HydraCollectionBaseSchema"},{"type":"object","properties":{"member":{"type":"array","items":{"$ref":"#/components/schemas/TaskHistory.jsonld"}}}}]}},"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/TaskHistory"}}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/Error.jsonld"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}},"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"links":{}}},"summary":"Retrieves the collection of TaskHistory resources.","description":"Retrieves the collection of TaskHistory resources.","parameters":[{"name":"taskId","in":"path","description":"TaskHistory identifier","required":true,"deprecated":false,"schema":{"type":"string"},"style":"simple","explode":false},{"name":"page","in":"query","description":"The collection page number","required":false,"deprecated":false,"schema":{"type":"integer","default":1},"style":"form","explode":false},{"name":"itemsPerPage","in":"query","description":"The number of items per page","required":false,"deprecated":false,"schema":{"type":"integer","default":15,"minimum":0,"maximum":30},"style":"form","explode":false},{"name":"order[createdAt]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string","default":"asc","enum":["asc","desc"]},"style":"form","explode":false}]}}}}
```