# 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}]}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developer.rogerroger.io/tasks.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.