Unified.to · Capability
Unified.to API — collection
Unified.to API — collection. 12 operations. Lead operation: List All Collections. Self-contained Naftiko capability covering one Unified To business surface.
What You Can Do
GET
Listcommercecollections
— List All Collections
/v1/commerce/{connection-id}/collection
POST
Createcommercecollection
— Create a Collection
/v1/commerce/{connection-id}/collection
DELETE
Removecommercecollection
— Remove a Collection
/v1/commerce/{connection-id}/collection/{id}
GET
Getcommercecollection
— Retrieve a Collection
/v1/commerce/{connection-id}/collection/{id}
PATCH
Patchcommercecollection
— Update a Collection
/v1/commerce/{connection-id}/collection/{id}
PUT
Updatecommercecollection
— Update a Collection
/v1/commerce/{connection-id}/collection/{id}
GET
Listlmscollections
— List All Collections
/v1/lms/{connection-id}/collection
POST
Createlmscollection
— Create a Collection
/v1/lms/{connection-id}/collection
DELETE
Removelmscollection
— Remove a Collection
/v1/lms/{connection-id}/collection/{id}
GET
Getlmscollection
— Retrieve a Collection
/v1/lms/{connection-id}/collection/{id}
PATCH
Patchlmscollection
— Update a Collection
/v1/lms/{connection-id}/collection/{id}
PUT
Updatelmscollection
— Update a Collection
/v1/lms/{connection-id}/collection/{id}
MCP Tools
list-all-collections
List All Collections
read-only
idempotent
create-collection
Create a Collection
remove-collection
Remove a Collection
idempotent
retrieve-collection
Retrieve a Collection
read-only
idempotent
update-collection
Update a Collection
idempotent
update-collection-2
Update a Collection
idempotent
list-all-collections-2
List All Collections
read-only
idempotent
create-collection-2
Create a Collection
remove-collection-2
Remove a Collection
idempotent
retrieve-collection-2
Retrieve a Collection
read-only
idempotent
update-collection-3
Update a Collection
idempotent
update-collection-4
Update a Collection
idempotent
Capability Spec
naftiko: 1.0.0-alpha2
info:
label: Unified.to API — collection
description: 'Unified.to API — collection. 12 operations. Lead operation: List All Collections. Self-contained Naftiko
capability covering one Unified To business surface.'
tags:
- Unified To
- collection
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-collection
baseUri: https://api.unified.to
description: Unified.to API — collection business capability. Self-contained, no shared references.
resources:
- name: commerce-connection_id-collection
path: /commerce/{connection_id}/collection
operations:
- name: listcommercecollections
method: GET
description: List All Collections
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: type
in: query
type: string
- name: parent_id
in: query
type: string
description: The parent ID to filter by
- name: saleschannel_id
in: query
type: string
description: The saleschannel ID to filter by (reference to CommerceSaleschannel)
- name: org_id
in: query
type: string
description: The org ID to filter by (reference to AccountingOrganization)
- 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: createcommercecollection
method: POST
description: Create a Collection
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: commerce-connection_id-collection-id
path: /commerce/{connection_id}/collection/{id}
operations:
- name: removecommercecollection
method: DELETE
description: Remove a Collection
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 Collection
required: true
- name: getcommercecollection
method: GET
description: Retrieve a Collection
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 Collection
required: true
- name: patchcommercecollection
method: PATCH
description: Update a Collection
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 Collection
required: true
- name: body
in: body
type: object
description: Request body (JSON).
required: true
- name: updatecommercecollection
method: PUT
description: Update a Collection
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 Collection
required: true
- name: body
in: body
type: object
description: Request body (JSON).
required: true
- name: lms-connection_id-collection
path: /lms/{connection_id}/collection
operations:
- name: listlmscollections
method: GET
description: List All Collections
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: course_id
in: query
type: string
description: The course ID to filter by (reference to Course)
- 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: createlmscollection
method: POST
description: Create a Collection
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: lms-connection_id-collection-id
path: /lms/{connection_id}/collection/{id}
operations:
- name: removelmscollection
method: DELETE
description: Remove a Collection
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 Collection
required: true
- name: getlmscollection
method: GET
description: Retrieve a Collection
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 Collection
required: true
- name: patchlmscollection
method: PATCH
description: Update a Collection
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 Collection
required: true
- name: body
in: body
type: object
description: Request body (JSON).
required: true
- name: updatelmscollection
method: PUT
description: Update a Collection
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 Collection
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-collection-rest
port: 8080
description: REST adapter for Unified.to API — collection. One Spectral-compliant resource per consumed operation, prefixed
with /v1.
resources:
- path: /v1/commerce/{connection-id}/collection
name: commerce-connection-id-collection
description: REST surface for commerce-connection_id-collection.
operations:
- method: GET
name: listcommercecollections
description: List All Collections
call: full-collection.listcommercecollections
with:
limit: rest.limit
offset: rest.offset
updated_gte: rest.updated_gte
sort: rest.sort
order: rest.order
query: rest.query
type: rest.type
parent_id: rest.parent_id
saleschannel_id: rest.saleschannel_id
org_id: rest.org_id
fields: rest.fields
raw: rest.raw
connection_id: rest.connection_id
outputParameters:
- type: object
mapping: $.
- method: POST
name: createcommercecollection
description: Create a Collection
call: full-collection.createcommercecollection
with:
fields: rest.fields
raw: rest.raw
connection_id: rest.connection_id
body: rest.body
outputParameters:
- type: object
mapping: $.
- path: /v1/commerce/{connection-id}/collection/{id}
name: commerce-connection-id-collection-id
description: REST surface for commerce-connection_id-collection-id.
operations:
- method: DELETE
name: removecommercecollection
description: Remove a Collection
call: full-collection.removecommercecollection
with:
connection_id: rest.connection_id
id: rest.id
outputParameters:
- type: object
mapping: $.
- method: GET
name: getcommercecollection
description: Retrieve a Collection
call: full-collection.getcommercecollection
with:
fields: rest.fields
raw: rest.raw
connection_id: rest.connection_id
id: rest.id
outputParameters:
- type: object
mapping: $.
- method: PATCH
name: patchcommercecollection
description: Update a Collection
call: full-collection.patchcommercecollection
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: updatecommercecollection
description: Update a Collection
call: full-collection.updatecommercecollection
with:
fields: rest.fields
raw: rest.raw
connection_id: rest.connection_id
id: rest.id
body: rest.body
outputParameters:
- type: object
mapping: $.
- path: /v1/lms/{connection-id}/collection
name: lms-connection-id-collection
description: REST surface for lms-connection_id-collection.
operations:
- method: GET
name: listlmscollections
description: List All Collections
call: full-collection.listlmscollections
with:
limit: rest.limit
offset: rest.offset
updated_gte: rest.updated_gte
sort: rest.sort
order: rest.order
query: rest.query
course_id: rest.course_id
parent_id: rest.parent_id
fields: rest.fields
raw: rest.raw
connection_id: rest.connection_id
outputParameters:
- type: object
mapping: $.
- method: POST
name: createlmscollection
description: Create a Collection
call: full-collection.createlmscollection
with:
fields: rest.fields
raw: rest.raw
connection_id: rest.connection_id
body: rest.body
outputParameters:
- type: object
mapping: $.
- path: /v1/lms/{connection-id}/collection/{id}
name: lms-connection-id-collection-id
description: REST surface for lms-connection_id-collection-id.
operations:
- method: DELETE
name: removelmscollection
description: Remove a Collection
call: full-collection.removelmscollection
with:
connection_id: rest.connection_id
id: rest.id
outputParameters:
- type: object
mapping: $.
- method: GET
name: getlmscollection
description: Retrieve a Collection
call: full-collection.getlmscollection
with:
fields: rest.fields
raw: rest.raw
connection_id: rest.connection_id
id: rest.id
outputParameters:
- type: object
mapping: $.
- method: PATCH
name: patchlmscollection
description: Update a Collection
call: full-collection.patchlmscollection
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: updatelmscollection
description: Update a Collection
call: full-collection.updatelmscollection
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-collection-mcp
port: 9090
transport: http
description: MCP adapter for Unified.to API — collection. One tool per consumed operation, routed inline through this
capability's consumes block.
tools:
- name: list-all-collections
description: List All Collections
hints:
readOnly: true
destructive: false
idempotent: true
call: full-collection.listcommercecollections
with:
limit: tools.limit
offset: tools.offset
updated_gte: tools.updated_gte
sort: tools.sort
order: tools.order
query: tools.query
type: tools.type
parent_id: tools.parent_id
saleschannel_id: tools.saleschannel_id
org_id: tools.org_id
fields: tools.fields
raw: tools.raw
connection_id: tools.connection_id
outputParameters:
- type: object
mapping: $.
- name: create-collection
description: Create a Collection
hints:
readOnly: false
destructive: false
idempotent: false
call: full-collection.createcommercecollection
with:
fields: tools.fields
raw: tools.raw
connection_id: tools.connection_id
body: tools.body
outputParameters:
- type: object
mapping: $.
- name: remove-collection
description: Remove a Collection
hints:
readOnly: false
destructive: true
idempotent: true
call: full-collection.removecommercecollection
with:
connection_id: tools.connection_id
id: tools.id
outputParameters:
- type: object
mapping: $.
- name: retrieve-collection
description: Retrieve a Collection
hints:
readOnly: true
destructive: false
idempotent: true
call: full-collection.getcommercecollection
with:
fields: tools.fields
raw: tools.raw
connection_id: tools.connection_id
id: tools.id
outputParameters:
- type: object
mapping: $.
- name: update-collection
description: Update a Collection
hints:
readOnly: false
destructive: false
idempotent: true
call: full-collection.patchcommercecollection
with:
fields: tools.fields
raw: tools.raw
connection_id: tools.connection_id
id: tools.id
body: tools.body
outputParameters:
- type: object
mapping: $.
- name: update-collection-2
description: Update a Collection
hints:
readOnly: false
destructive: false
idempotent: true
call: full-collection.updatecommercecollection
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-collections-2
description: List All Collections
hints:
readOnly: true
destructive: false
idempotent: true
call: full-collection.listlmscollections
with:
limit: tools.limit
offset: tools.offset
updated_gte: tools.updated_gte
sort: tools.sort
order: tools.order
query: tools.query
course_id: tools.course_id
parent_id: tools.parent_id
fields: tools.fields
raw: tools.raw
connection_id: tools.connection_id
outputParameters:
- type: object
mapping: $.
- name: create-collection-2
description: Create a Collection
hints:
readOnly: false
destructive: false
idempotent: false
call: full-collection.createlmscollection
with:
fields: tools.fields
raw: tools.raw
connection_id: tools.connection_id
body: tools.body
outputParameters:
- type: object
mapping: $.
- name: remove-collection-2
description: Remove a Collection
hints:
readOnly: false
destructive: true
idempotent: true
call: full-collection.removelmscollection
with:
connection_id: tools.connection_id
id: tools.id
outputParameters:
- type: object
mapping: $.
- name: retrieve-collection-2
description: Retrieve a Collection
hints:
readOnly: true
destructive: false
idempotent: true
call: full-collection.getlmscollection
with:
fields: tools.fields
raw: tools.raw
connection_id: tools.connection_id
id: tools.id
outputParameters:
- type: object
mapping: $.
- name: update-collection-3
description: Update a Collection
hints:
readOnly: false
destructive: false
idempotent: true
call: full-collection.patchlmscollection
with:
fields: tools.fields
raw: tools.raw
connection_id: tools.connection_id
id: tools.id
body: tools.body
outputParameters:
- type: object
mapping: $.
- name: update-collection-4
description: Update a Collection
hints:
readOnly: false
destructive: false
idempotent: true
call: full-collection.updatelmscollection
with:
fields: tools.fields
raw: tools.raw
connection_id: tools.connection_id
id: tools.id
body: tools.body
outputParameters:
- type: object
mapping: $.