naftiko: 1.0.0-alpha2 info: label: Unified.to API — comment description: 'Unified.to API — comment. 18 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: full-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 - name: uc-connection_id-comment path: /uc/{connection_id}/comment operations: - name: listuccomments 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: user_id in: query type: string description: The user/employee ID to filter by (reference to HrisEmployee) - name: call_id in: query type: string description: The call 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: createuccomment 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: uc-connection_id-comment-id path: /uc/{connection_id}/comment/{id} operations: - name: removeuccomment 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: getuccomment 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: patchuccomment 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: updateuccomment 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: full-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: full-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: full-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: full-comment.removekmscomment with: connection_id: rest.connection_id id: rest.id outputParameters: - type: object mapping: $. - method: GET name: getkmscomment description: Retrieve a Comment call: full-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: full-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: full-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: full-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: full-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: full-comment.removetaskcomment with: connection_id: rest.connection_id id: rest.id outputParameters: - type: object mapping: $. - method: GET name: gettaskcomment description: Retrieve a Comment call: full-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: full-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: full-comment.updatetaskcomment with: fields: rest.fields raw: rest.raw connection_id: rest.connection_id id: rest.id body: rest.body outputParameters: - type: object mapping: $. - path: /v1/uc/{connection-id}/comment name: uc-connection-id-comment description: REST surface for uc-connection_id-comment. operations: - method: GET name: listuccomments description: List All Comments call: full-comment.listuccomments with: limit: rest.limit offset: rest.offset updated_gte: rest.updated_gte sort: rest.sort order: rest.order query: rest.query user_id: rest.user_id call_id: rest.call_id fields: rest.fields raw: rest.raw connection_id: rest.connection_id outputParameters: - type: object mapping: $. - method: POST name: createuccomment description: Create a Comment call: full-comment.createuccomment with: fields: rest.fields raw: rest.raw connection_id: rest.connection_id body: rest.body outputParameters: - type: object mapping: $. - path: /v1/uc/{connection-id}/comment/{id} name: uc-connection-id-comment-id description: REST surface for uc-connection_id-comment-id. operations: - method: DELETE name: removeuccomment description: Remove a Comment call: full-comment.removeuccomment with: connection_id: rest.connection_id id: rest.id outputParameters: - type: object mapping: $. - method: GET name: getuccomment description: Retrieve a Comment call: full-comment.getuccomment with: fields: rest.fields raw: rest.raw connection_id: rest.connection_id id: rest.id outputParameters: - type: object mapping: $. - method: PATCH name: patchuccomment description: Update a Comment call: full-comment.patchuccomment 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: updateuccomment description: Update a Comment call: full-comment.updateuccomment 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: full-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: full-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: full-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: full-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: full-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: full-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: full-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: full-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: full-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: full-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: full-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: full-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: full-comment.updatetaskcomment 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-3 description: List All Comments hints: readOnly: true destructive: false idempotent: true call: full-comment.listuccomments with: limit: tools.limit offset: tools.offset updated_gte: tools.updated_gte sort: tools.sort order: tools.order query: tools.query user_id: tools.user_id call_id: tools.call_id fields: tools.fields raw: tools.raw connection_id: tools.connection_id outputParameters: - type: object mapping: $. - name: create-comment-3 description: Create a Comment hints: readOnly: false destructive: false idempotent: false call: full-comment.createuccomment with: fields: tools.fields raw: tools.raw connection_id: tools.connection_id body: tools.body outputParameters: - type: object mapping: $. - name: remove-comment-3 description: Remove a Comment hints: readOnly: false destructive: true idempotent: true call: full-comment.removeuccomment with: connection_id: tools.connection_id id: tools.id outputParameters: - type: object mapping: $. - name: retrieve-comment-3 description: Retrieve a Comment hints: readOnly: true destructive: false idempotent: true call: full-comment.getuccomment with: fields: tools.fields raw: tools.raw connection_id: tools.connection_id id: tools.id outputParameters: - type: object mapping: $. - name: update-comment-5 description: Update a Comment hints: readOnly: false destructive: false idempotent: true call: full-comment.patchuccomment 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-6 description: Update a Comment hints: readOnly: false destructive: false idempotent: true call: full-comment.updateuccomment with: fields: tools.fields raw: tools.raw connection_id: tools.connection_id id: tools.id body: tools.body outputParameters: - type: object mapping: $.