Unified.to · Capability
Unified.to API — comment
Unified.to API — comment. 12 operations. Lead operation: List all comments. Self-contained Naftiko capability covering one Unified To business surface.
What You Can Do
GET
Listkmscomments
— List all comments
/v1/kms/{connection-id}/comment
POST
Createkmscomment
— Create a comment
/v1/kms/{connection-id}/comment
DELETE
Removekmscomment
— Remove a comment
/v1/kms/{connection-id}/comment/{id}
GET
Getkmscomment
— Retrieve a comment
/v1/kms/{connection-id}/comment/{id}
PATCH
Patchkmscomment
— Update a comment
/v1/kms/{connection-id}/comment/{id}
PUT
Updatekmscomment
— Update a comment
/v1/kms/{connection-id}/comment/{id}
GET
Listtaskcomments
— List all comments
/v1/task/{connection-id}/comment
POST
Createtaskcomment
— Create a comment
/v1/task/{connection-id}/comment
DELETE
Removetaskcomment
— Remove a comment
/v1/task/{connection-id}/comment/{id}
GET
Gettaskcomment
— Retrieve a comment
/v1/task/{connection-id}/comment/{id}
PATCH
Patchtaskcomment
— Update a comment
/v1/task/{connection-id}/comment/{id}
PUT
Updatetaskcomment
— Update a comment
/v1/task/{connection-id}/comment/{id}
MCP Tools
list-all-comments
List all comments
read-only
idempotent
create-comment
Create a comment
remove-comment
Remove a comment
idempotent
retrieve-comment
Retrieve a comment
read-only
idempotent
update-comment
Update a comment
idempotent
update-comment-2
Update a comment
idempotent
list-all-comments-2
List all comments
read-only
idempotent
create-comment-2
Create a comment
remove-comment-2
Remove a comment
idempotent
retrieve-comment-2
Retrieve a comment
read-only
idempotent
update-comment-3
Update a comment
idempotent
update-comment-4
Update a comment
idempotent
Capability Spec
naftiko: 1.0.0-alpha2
info:
label: Unified.to API — comment
description: 'Unified.to API — comment. 12 operations. Lead operation: List all comments. Self-contained Naftiko capability
covering one Unified To business surface.'
tags:
- Unified To
- comment
created: '2026-05-19'
modified: '2026-05-19'
binds:
- namespace: env
keys:
UNIFIED_TO_API_KEY: UNIFIED_TO_API_KEY
capability:
consumes:
- type: http
namespace: productivity-comment
baseUri: https://api.unified.to
description: Unified.to API — comment business capability. Self-contained, no shared references.
resources:
- name: kms-connection_id-comment
path: /kms/{connection_id}/comment
operations:
- name: listkmscomments
method: GET
description: List all comments
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: limit
in: query
type: number
- name: offset
in: query
type: number
- name: updated_gte
in: query
type: string
description: Return only results whose updated date is equal or greater to this value (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ
format)
- name: sort
in: query
type: string
- name: order
in: query
type: string
- name: query
in: query
type: string
description: Query string to search. eg. email address or name
- name: page_id
in: query
type: string
description: The page ID to filter by (reference to KmsPage)
- name: type
in: query
type: string
description: The type to filter by
- name: parent_id
in: query
type: string
description: The parent ID to filter by
- name: fields
in: query
type: array
description: Fields to return
- name: raw
in: query
type: string
description: 'Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters:
foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar'
- name: connection_id
in: path
type: string
description: ID of the connection
required: true
- name: createkmscomment
method: POST
description: Create a comment
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: fields
in: query
type: array
description: Fields to return
- name: raw
in: query
type: string
description: 'Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters:
foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar'
- name: connection_id
in: path
type: string
description: ID of the connection
required: true
- name: body
in: body
type: object
description: Request body (JSON).
required: true
- name: kms-connection_id-comment-id
path: /kms/{connection_id}/comment/{id}
operations:
- name: removekmscomment
method: DELETE
description: Remove a comment
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: connection_id
in: path
type: string
description: ID of the connection
required: true
- name: id
in: path
type: string
description: ID of the Comment
required: true
- name: getkmscomment
method: GET
description: Retrieve a comment
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: fields
in: query
type: array
description: Fields to return
- name: raw
in: query
type: string
description: 'Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters:
foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar'
- name: connection_id
in: path
type: string
description: ID of the connection
required: true
- name: id
in: path
type: string
description: ID of the Comment
required: true
- name: patchkmscomment
method: PATCH
description: Update a comment
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: fields
in: query
type: array
description: Fields to return
- name: raw
in: query
type: string
description: 'Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters:
foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar'
- name: connection_id
in: path
type: string
description: ID of the connection
required: true
- name: id
in: path
type: string
description: ID of the Comment
required: true
- name: body
in: body
type: object
description: Request body (JSON).
required: true
- name: updatekmscomment
method: PUT
description: Update a comment
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: fields
in: query
type: array
description: Fields to return
- name: raw
in: query
type: string
description: 'Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters:
foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar'
- name: connection_id
in: path
type: string
description: ID of the connection
required: true
- name: id
in: path
type: string
description: ID of the Comment
required: true
- name: body
in: body
type: object
description: Request body (JSON).
required: true
- name: task-connection_id-comment
path: /task/{connection_id}/comment
operations:
- name: listtaskcomments
method: GET
description: List all comments
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: limit
in: query
type: number
- name: offset
in: query
type: number
- name: updated_gte
in: query
type: string
description: Return only results whose updated date is equal or greater to this value (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ
format)
- name: sort
in: query
type: string
- name: order
in: query
type: string
- name: query
in: query
type: string
description: Query string to search. eg. email address or name
- name: task_id
in: query
type: string
description: The task ID to filter by (reference to TaskTask)
- name: fields
in: query
type: array
description: Fields to return
- name: raw
in: query
type: string
description: 'Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters:
foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar'
- name: connection_id
in: path
type: string
description: ID of the connection
required: true
- name: createtaskcomment
method: POST
description: Create a comment
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: fields
in: query
type: array
description: Fields to return
- name: raw
in: query
type: string
description: 'Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters:
foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar'
- name: connection_id
in: path
type: string
description: ID of the connection
required: true
- name: body
in: body
type: object
description: Request body (JSON).
required: true
- name: task-connection_id-comment-id
path: /task/{connection_id}/comment/{id}
operations:
- name: removetaskcomment
method: DELETE
description: Remove a comment
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: connection_id
in: path
type: string
description: ID of the connection
required: true
- name: id
in: path
type: string
description: ID of the Comment
required: true
- name: gettaskcomment
method: GET
description: Retrieve a comment
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: fields
in: query
type: array
description: Fields to return
- name: raw
in: query
type: string
description: 'Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters:
foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar'
- name: connection_id
in: path
type: string
description: ID of the connection
required: true
- name: id
in: path
type: string
description: ID of the Comment
required: true
- name: patchtaskcomment
method: PATCH
description: Update a comment
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: fields
in: query
type: array
description: Fields to return
- name: raw
in: query
type: string
description: 'Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters:
foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar'
- name: connection_id
in: path
type: string
description: ID of the connection
required: true
- name: id
in: path
type: string
description: ID of the Comment
required: true
- name: body
in: body
type: object
description: Request body (JSON).
required: true
- name: updatetaskcomment
method: PUT
description: Update a comment
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: fields
in: query
type: array
description: Fields to return
- name: raw
in: query
type: string
description: 'Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters:
foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar'
- name: connection_id
in: path
type: string
description: ID of the connection
required: true
- name: id
in: path
type: string
description: ID of the Comment
required: true
- name: body
in: body
type: object
description: Request body (JSON).
required: true
authentication:
type: apikey
key: authorization
value: '{{env.UNIFIED_TO_API_KEY}}'
placement: header
exposes:
- type: rest
namespace: productivity-comment-rest
port: 8080
description: REST adapter for Unified.to API — comment. One Spectral-compliant resource per consumed operation, prefixed
with /v1.
resources:
- path: /v1/kms/{connection-id}/comment
name: kms-connection-id-comment
description: REST surface for kms-connection_id-comment.
operations:
- method: GET
name: listkmscomments
description: List all comments
call: productivity-comment.listkmscomments
with:
limit: rest.limit
offset: rest.offset
updated_gte: rest.updated_gte
sort: rest.sort
order: rest.order
query: rest.query
page_id: rest.page_id
type: rest.type
parent_id: rest.parent_id
fields: rest.fields
raw: rest.raw
connection_id: rest.connection_id
outputParameters:
- type: object
mapping: $.
- method: POST
name: createkmscomment
description: Create a comment
call: productivity-comment.createkmscomment
with:
fields: rest.fields
raw: rest.raw
connection_id: rest.connection_id
body: rest.body
outputParameters:
- type: object
mapping: $.
- path: /v1/kms/{connection-id}/comment/{id}
name: kms-connection-id-comment-id
description: REST surface for kms-connection_id-comment-id.
operations:
- method: DELETE
name: removekmscomment
description: Remove a comment
call: productivity-comment.removekmscomment
with:
connection_id: rest.connection_id
id: rest.id
outputParameters:
- type: object
mapping: $.
- method: GET
name: getkmscomment
description: Retrieve a comment
call: productivity-comment.getkmscomment
with:
fields: rest.fields
raw: rest.raw
connection_id: rest.connection_id
id: rest.id
outputParameters:
- type: object
mapping: $.
- method: PATCH
name: patchkmscomment
description: Update a comment
call: productivity-comment.patchkmscomment
with:
fields: rest.fields
raw: rest.raw
connection_id: rest.connection_id
id: rest.id
body: rest.body
outputParameters:
- type: object
mapping: $.
- method: PUT
name: updatekmscomment
description: Update a comment
call: productivity-comment.updatekmscomment
with:
fields: rest.fields
raw: rest.raw
connection_id: rest.connection_id
id: rest.id
body: rest.body
outputParameters:
- type: object
mapping: $.
- path: /v1/task/{connection-id}/comment
name: task-connection-id-comment
description: REST surface for task-connection_id-comment.
operations:
- method: GET
name: listtaskcomments
description: List all comments
call: productivity-comment.listtaskcomments
with:
limit: rest.limit
offset: rest.offset
updated_gte: rest.updated_gte
sort: rest.sort
order: rest.order
query: rest.query
task_id: rest.task_id
fields: rest.fields
raw: rest.raw
connection_id: rest.connection_id
outputParameters:
- type: object
mapping: $.
- method: POST
name: createtaskcomment
description: Create a comment
call: productivity-comment.createtaskcomment
with:
fields: rest.fields
raw: rest.raw
connection_id: rest.connection_id
body: rest.body
outputParameters:
- type: object
mapping: $.
- path: /v1/task/{connection-id}/comment/{id}
name: task-connection-id-comment-id
description: REST surface for task-connection_id-comment-id.
operations:
- method: DELETE
name: removetaskcomment
description: Remove a comment
call: productivity-comment.removetaskcomment
with:
connection_id: rest.connection_id
id: rest.id
outputParameters:
- type: object
mapping: $.
- method: GET
name: gettaskcomment
description: Retrieve a comment
call: productivity-comment.gettaskcomment
with:
fields: rest.fields
raw: rest.raw
connection_id: rest.connection_id
id: rest.id
outputParameters:
- type: object
mapping: $.
- method: PATCH
name: patchtaskcomment
description: Update a comment
call: productivity-comment.patchtaskcomment
with:
fields: rest.fields
raw: rest.raw
connection_id: rest.connection_id
id: rest.id
body: rest.body
outputParameters:
- type: object
mapping: $.
- method: PUT
name: updatetaskcomment
description: Update a comment
call: productivity-comment.updatetaskcomment
with:
fields: rest.fields
raw: rest.raw
connection_id: rest.connection_id
id: rest.id
body: rest.body
outputParameters:
- type: object
mapping: $.
- type: mcp
namespace: productivity-comment-mcp
port: 9090
transport: http
description: MCP adapter for Unified.to API — comment. One tool per consumed operation, routed inline through this capability's
consumes block.
tools:
- name: list-all-comments
description: List all comments
hints:
readOnly: true
destructive: false
idempotent: true
call: productivity-comment.listkmscomments
with:
limit: tools.limit
offset: tools.offset
updated_gte: tools.updated_gte
sort: tools.sort
order: tools.order
query: tools.query
page_id: tools.page_id
type: tools.type
parent_id: tools.parent_id
fields: tools.fields
raw: tools.raw
connection_id: tools.connection_id
outputParameters:
- type: object
mapping: $.
- name: create-comment
description: Create a comment
hints:
readOnly: false
destructive: false
idempotent: false
call: productivity-comment.createkmscomment
with:
fields: tools.fields
raw: tools.raw
connection_id: tools.connection_id
body: tools.body
outputParameters:
- type: object
mapping: $.
- name: remove-comment
description: Remove a comment
hints:
readOnly: false
destructive: true
idempotent: true
call: productivity-comment.removekmscomment
with:
connection_id: tools.connection_id
id: tools.id
outputParameters:
- type: object
mapping: $.
- name: retrieve-comment
description: Retrieve a comment
hints:
readOnly: true
destructive: false
idempotent: true
call: productivity-comment.getkmscomment
with:
fields: tools.fields
raw: tools.raw
connection_id: tools.connection_id
id: tools.id
outputParameters:
- type: object
mapping: $.
- name: update-comment
description: Update a comment
hints:
readOnly: false
destructive: false
idempotent: true
call: productivity-comment.patchkmscomment
with:
fields: tools.fields
raw: tools.raw
connection_id: tools.connection_id
id: tools.id
body: tools.body
outputParameters:
- type: object
mapping: $.
- name: update-comment-2
description: Update a comment
hints:
readOnly: false
destructive: false
idempotent: true
call: productivity-comment.updatekmscomment
with:
fields: tools.fields
raw: tools.raw
connection_id: tools.connection_id
id: tools.id
body: tools.body
outputParameters:
- type: object
mapping: $.
- name: list-all-comments-2
description: List all comments
hints:
readOnly: true
destructive: false
idempotent: true
call: productivity-comment.listtaskcomments
with:
limit: tools.limit
offset: tools.offset
updated_gte: tools.updated_gte
sort: tools.sort
order: tools.order
query: tools.query
task_id: tools.task_id
fields: tools.fields
raw: tools.raw
connection_id: tools.connection_id
outputParameters:
- type: object
mapping: $.
- name: create-comment-2
description: Create a comment
hints:
readOnly: false
destructive: false
idempotent: false
call: productivity-comment.createtaskcomment
with:
fields: tools.fields
raw: tools.raw
connection_id: tools.connection_id
body: tools.body
outputParameters:
- type: object
mapping: $.
- name: remove-comment-2
description: Remove a comment
hints:
readOnly: false
destructive: true
idempotent: true
call: productivity-comment.removetaskcomment
with:
connection_id: tools.connection_id
id: tools.id
outputParameters:
- type: object
mapping: $.
- name: retrieve-comment-2
description: Retrieve a comment
hints:
readOnly: true
destructive: false
idempotent: true
call: productivity-comment.gettaskcomment
with:
fields: tools.fields
raw: tools.raw
connection_id: tools.connection_id
id: tools.id
outputParameters:
- type: object
mapping: $.
- name: update-comment-3
description: Update a comment
hints:
readOnly: false
destructive: false
idempotent: true
call: productivity-comment.patchtaskcomment
with:
fields: tools.fields
raw: tools.raw
connection_id: tools.connection_id
id: tools.id
body: tools.body
outputParameters:
- type: object
mapping: $.
- name: update-comment-4
description: Update a comment
hints:
readOnly: false
destructive: false
idempotent: true
call: productivity-comment.updatetaskcomment
with:
fields: tools.fields
raw: tools.raw
connection_id: tools.connection_id
id: tools.id
body: tools.body
outputParameters:
- type: object
mapping: $.