Unified.to · Capability
Unified.to API — user
Unified.to API — user. 6 operations. Lead operation: List users. Self-contained Naftiko capability covering one Unified To business surface.
What You Can Do
GET
Listscimusers
— List users
/v1/scim/{connection-id}/users
POST
Createscimusers
— Create user
/v1/scim/{connection-id}/users
DELETE
Removescimusers
— Delete user
/v1/scim/{connection-id}/users/{id}
GET
Getscimusers
— Get user
/v1/scim/{connection-id}/users/{id}
PATCH
Patchscimusers
— Update user
/v1/scim/{connection-id}/users/{id}
PUT
Updatescimusers
— Update user
/v1/scim/{connection-id}/users/{id}
MCP Tools
list-users
List users
read-only
idempotent
create-user
Create user
delete-user
Delete user
idempotent
get-user
Get user
read-only
idempotent
update-user
Update user
idempotent
update-user-2
Update user
idempotent
Capability Spec
naftiko: 1.0.0-alpha2
info:
label: Unified.to API — user
description: 'Unified.to API — user. 6 operations. Lead operation: List users. Self-contained Naftiko capability covering
one Unified To business surface.'
tags:
- Unified To
- user
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: it-ops-user
baseUri: https://api.unified.to
description: Unified.to API — user business capability. Self-contained, no shared references.
resources:
- name: scim-connection_id-users
path: /scim/{connection_id}/users
operations:
- name: listscimusers
method: GET
description: List users
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: filter
in: query
type: string
- name: sortBy
in: query
type: string
- name: sortOrder
in: query
type: string
- name: startIndex
in: query
type: number
- name: count
in: query
type: number
- name: connection_id
in: path
type: string
description: ID of the connection
required: true
- name: createscimusers
method: POST
description: Create user
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: filter
in: query
type: string
- name: sortBy
in: query
type: string
- name: sortOrder
in: query
type: string
- name: startIndex
in: query
type: number
- name: count
in: query
type: number
- 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: scim-connection_id-users-id
path: /scim/{connection_id}/users/{id}
operations:
- name: removescimusers
method: DELETE
description: Delete user
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 User
required: true
- name: getscimusers
method: GET
description: Get user
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 User
required: true
- name: patchscimusers
method: PATCH
description: Update user
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 User
required: true
- name: body
in: body
type: object
description: Request body (JSON).
required: true
- name: updatescimusers
method: PUT
description: Update user
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 User
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: it-ops-user-rest
port: 8080
description: REST adapter for Unified.to API — user. One Spectral-compliant resource per consumed operation, prefixed
with /v1.
resources:
- path: /v1/scim/{connection-id}/users
name: scim-connection-id-users
description: REST surface for scim-connection_id-users.
operations:
- method: GET
name: listscimusers
description: List users
call: it-ops-user.listscimusers
with:
filter: rest.filter
sortBy: rest.sortBy
sortOrder: rest.sortOrder
startIndex: rest.startIndex
count: rest.count
connection_id: rest.connection_id
outputParameters:
- type: object
mapping: $.
- method: POST
name: createscimusers
description: Create user
call: it-ops-user.createscimusers
with:
filter: rest.filter
sortBy: rest.sortBy
sortOrder: rest.sortOrder
startIndex: rest.startIndex
count: rest.count
connection_id: rest.connection_id
body: rest.body
outputParameters:
- type: object
mapping: $.
- path: /v1/scim/{connection-id}/users/{id}
name: scim-connection-id-users-id
description: REST surface for scim-connection_id-users-id.
operations:
- method: DELETE
name: removescimusers
description: Delete user
call: it-ops-user.removescimusers
with:
connection_id: rest.connection_id
id: rest.id
outputParameters:
- type: object
mapping: $.
- method: GET
name: getscimusers
description: Get user
call: it-ops-user.getscimusers
with:
connection_id: rest.connection_id
id: rest.id
outputParameters:
- type: object
mapping: $.
- method: PATCH
name: patchscimusers
description: Update user
call: it-ops-user.patchscimusers
with:
connection_id: rest.connection_id
id: rest.id
body: rest.body
outputParameters:
- type: object
mapping: $.
- method: PUT
name: updatescimusers
description: Update user
call: it-ops-user.updatescimusers
with:
connection_id: rest.connection_id
id: rest.id
body: rest.body
outputParameters:
- type: object
mapping: $.
- type: mcp
namespace: it-ops-user-mcp
port: 9090
transport: http
description: MCP adapter for Unified.to API — user. One tool per consumed operation, routed inline through this capability's
consumes block.
tools:
- name: list-users
description: List users
hints:
readOnly: true
destructive: false
idempotent: true
call: it-ops-user.listscimusers
with:
filter: tools.filter
sortBy: tools.sortBy
sortOrder: tools.sortOrder
startIndex: tools.startIndex
count: tools.count
connection_id: tools.connection_id
outputParameters:
- type: object
mapping: $.
- name: create-user
description: Create user
hints:
readOnly: false
destructive: false
idempotent: false
call: it-ops-user.createscimusers
with:
filter: tools.filter
sortBy: tools.sortBy
sortOrder: tools.sortOrder
startIndex: tools.startIndex
count: tools.count
connection_id: tools.connection_id
body: tools.body
outputParameters:
- type: object
mapping: $.
- name: delete-user
description: Delete user
hints:
readOnly: false
destructive: true
idempotent: true
call: it-ops-user.removescimusers
with:
connection_id: tools.connection_id
id: tools.id
outputParameters:
- type: object
mapping: $.
- name: get-user
description: Get user
hints:
readOnly: true
destructive: false
idempotent: true
call: it-ops-user.getscimusers
with:
connection_id: tools.connection_id
id: tools.id
outputParameters:
- type: object
mapping: $.
- name: update-user
description: Update user
hints:
readOnly: false
destructive: false
idempotent: true
call: it-ops-user.patchscimusers
with:
connection_id: tools.connection_id
id: tools.id
body: tools.body
outputParameters:
- type: object
mapping: $.
- name: update-user-2
description: Update user
hints:
readOnly: false
destructive: false
idempotent: true
call: it-ops-user.updatescimusers
with:
connection_id: tools.connection_id
id: tools.id
body: tools.body
outputParameters:
- type: object
mapping: $.