Unified.to · Capability
Unified.to API — forms
Unified.to API — forms. 8 operations. Lead operation: List All Forms. Self-contained Naftiko capability covering one Unified To business surface.
What You Can Do
GET
Listformsforms
— List All Forms
/v1/forms/{connection-id}/form
POST
Createformsform
— Create a Form
/v1/forms/{connection-id}/form
DELETE
Removeformsform
— Remove a Form
/v1/forms/{connection-id}/form/{id}
GET
Getformsform
— Retrieve a Form
/v1/forms/{connection-id}/form/{id}
PATCH
Patchformsform
— Update a Form
/v1/forms/{connection-id}/form/{id}
PUT
Updateformsform
— Update a Form
/v1/forms/{connection-id}/form/{id}
GET
Listformssubmissions
— List All Submissions
/v1/forms/{connection-id}/submission
GET
Getformssubmission
— Retrieve a Submission
/v1/forms/{connection-id}/submission/{id}
MCP Tools
list-all-forms
List All Forms
read-only
idempotent
create-form
Create a Form
remove-form
Remove a Form
idempotent
retrieve-form
Retrieve a Form
read-only
idempotent
update-form
Update a Form
idempotent
update-form-2
Update a Form
idempotent
list-all-submissions
List All Submissions
read-only
idempotent
retrieve-submission
Retrieve a Submission
read-only
idempotent
Capability Spec
naftiko: 1.0.0-alpha2
info:
label: Unified.to API — forms
description: 'Unified.to API — forms. 8 operations. Lead operation: List All Forms. Self-contained Naftiko capability covering
one Unified To business surface.'
tags:
- Unified To
- forms
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-forms
baseUri: https://api.unified.to
description: Unified.to API — forms business capability. Self-contained, no shared references.
resources:
- name: forms-connection_id-form
path: /forms/{connection_id}/form
operations:
- name: listformsforms
method: GET
description: List All Forms
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: 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: createformsform
method: POST
description: Create a Form
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: forms-connection_id-form-id
path: /forms/{connection_id}/form/{id}
operations:
- name: removeformsform
method: DELETE
description: Remove a Form
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 Form
required: true
- name: getformsform
method: GET
description: Retrieve a Form
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 Form
required: true
- name: patchformsform
method: PATCH
description: Update a Form
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 Form
required: true
- name: body
in: body
type: object
description: Request body (JSON).
required: true
- name: updateformsform
method: PUT
description: Update a Form
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 Form
required: true
- name: body
in: body
type: object
description: Request body (JSON).
required: true
- name: forms-connection_id-submission
path: /forms/{connection_id}/submission
operations:
- name: listformssubmissions
method: GET
description: List All Submissions
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: form_id
in: query
type: string
description: The form 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: forms-connection_id-submission-id
path: /forms/{connection_id}/submission/{id}
operations:
- name: getformssubmission
method: GET
description: Retrieve a Submission
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 Submission
required: true
authentication:
type: apikey
key: authorization
value: '{{env.UNIFIED_TO_API_KEY}}'
placement: header
exposes:
- type: rest
namespace: full-forms-rest
port: 8080
description: REST adapter for Unified.to API — forms. One Spectral-compliant resource per consumed operation, prefixed
with /v1.
resources:
- path: /v1/forms/{connection-id}/form
name: forms-connection-id-form
description: REST surface for forms-connection_id-form.
operations:
- method: GET
name: listformsforms
description: List All Forms
call: full-forms.listformsforms
with:
limit: rest.limit
offset: rest.offset
updated_gte: rest.updated_gte
sort: rest.sort
order: rest.order
query: rest.query
fields: rest.fields
raw: rest.raw
connection_id: rest.connection_id
outputParameters:
- type: object
mapping: $.
- method: POST
name: createformsform
description: Create a Form
call: full-forms.createformsform
with:
fields: rest.fields
raw: rest.raw
connection_id: rest.connection_id
body: rest.body
outputParameters:
- type: object
mapping: $.
- path: /v1/forms/{connection-id}/form/{id}
name: forms-connection-id-form-id
description: REST surface for forms-connection_id-form-id.
operations:
- method: DELETE
name: removeformsform
description: Remove a Form
call: full-forms.removeformsform
with:
connection_id: rest.connection_id
id: rest.id
outputParameters:
- type: object
mapping: $.
- method: GET
name: getformsform
description: Retrieve a Form
call: full-forms.getformsform
with:
fields: rest.fields
raw: rest.raw
connection_id: rest.connection_id
id: rest.id
outputParameters:
- type: object
mapping: $.
- method: PATCH
name: patchformsform
description: Update a Form
call: full-forms.patchformsform
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: updateformsform
description: Update a Form
call: full-forms.updateformsform
with:
fields: rest.fields
raw: rest.raw
connection_id: rest.connection_id
id: rest.id
body: rest.body
outputParameters:
- type: object
mapping: $.
- path: /v1/forms/{connection-id}/submission
name: forms-connection-id-submission
description: REST surface for forms-connection_id-submission.
operations:
- method: GET
name: listformssubmissions
description: List All Submissions
call: full-forms.listformssubmissions
with:
limit: rest.limit
offset: rest.offset
updated_gte: rest.updated_gte
sort: rest.sort
order: rest.order
query: rest.query
form_id: rest.form_id
fields: rest.fields
raw: rest.raw
connection_id: rest.connection_id
outputParameters:
- type: object
mapping: $.
- path: /v1/forms/{connection-id}/submission/{id}
name: forms-connection-id-submission-id
description: REST surface for forms-connection_id-submission-id.
operations:
- method: GET
name: getformssubmission
description: Retrieve a Submission
call: full-forms.getformssubmission
with:
fields: rest.fields
raw: rest.raw
connection_id: rest.connection_id
id: rest.id
outputParameters:
- type: object
mapping: $.
- type: mcp
namespace: full-forms-mcp
port: 9090
transport: http
description: MCP adapter for Unified.to API — forms. One tool per consumed operation, routed inline through this capability's
consumes block.
tools:
- name: list-all-forms
description: List All Forms
hints:
readOnly: true
destructive: false
idempotent: true
call: full-forms.listformsforms
with:
limit: tools.limit
offset: tools.offset
updated_gte: tools.updated_gte
sort: tools.sort
order: tools.order
query: tools.query
fields: tools.fields
raw: tools.raw
connection_id: tools.connection_id
outputParameters:
- type: object
mapping: $.
- name: create-form
description: Create a Form
hints:
readOnly: false
destructive: false
idempotent: false
call: full-forms.createformsform
with:
fields: tools.fields
raw: tools.raw
connection_id: tools.connection_id
body: tools.body
outputParameters:
- type: object
mapping: $.
- name: remove-form
description: Remove a Form
hints:
readOnly: false
destructive: true
idempotent: true
call: full-forms.removeformsform
with:
connection_id: tools.connection_id
id: tools.id
outputParameters:
- type: object
mapping: $.
- name: retrieve-form
description: Retrieve a Form
hints:
readOnly: true
destructive: false
idempotent: true
call: full-forms.getformsform
with:
fields: tools.fields
raw: tools.raw
connection_id: tools.connection_id
id: tools.id
outputParameters:
- type: object
mapping: $.
- name: update-form
description: Update a Form
hints:
readOnly: false
destructive: false
idempotent: true
call: full-forms.patchformsform
with:
fields: tools.fields
raw: tools.raw
connection_id: tools.connection_id
id: tools.id
body: tools.body
outputParameters:
- type: object
mapping: $.
- name: update-form-2
description: Update a Form
hints:
readOnly: false
destructive: false
idempotent: true
call: full-forms.updateformsform
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-submissions
description: List All Submissions
hints:
readOnly: true
destructive: false
idempotent: true
call: full-forms.listformssubmissions
with:
limit: tools.limit
offset: tools.offset
updated_gte: tools.updated_gte
sort: tools.sort
order: tools.order
query: tools.query
form_id: tools.form_id
fields: tools.fields
raw: tools.raw
connection_id: tools.connection_id
outputParameters:
- type: object
mapping: $.
- name: retrieve-submission
description: Retrieve a Submission
hints:
readOnly: true
destructive: false
idempotent: true
call: full-forms.getformssubmission
with:
fields: tools.fields
raw: tools.raw
connection_id: tools.connection_id
id: tools.id
outputParameters:
- type: object
mapping: $.