Deel · Capability
Endpoints — subpackage_groups
Endpoints — subpackage_groups. 5 operations. Lead operation: Create a group. Self-contained Naftiko capability covering one Deel business surface.
What You Can Do
POST
Creategroup
— Create a group
/v1/groups
GET
Getgroups
— Return list of groups
/v1/groups
DELETE
Deletegroup
— Delete a group
/v1/groups/{id}
PATCH
Updategroup
— Edit a group
/v1/groups/{id}
POST
Clonegroup
— Clone a Group
/v1/groups/{id}/clone
MCP Tools
create-group
Create a group
return-list-groups
Return list of groups
read-only
idempotent
delete-group
Delete a group
idempotent
edit-group
Edit a group
idempotent
clone-group
Clone a Group
Capability Spec
naftiko: 1.0.0-alpha2
info:
label: Endpoints — subpackage_groups
description: 'Endpoints — subpackage_groups. 5 operations. Lead operation: Create a group. Self-contained Naftiko capability
covering one Deel business surface.'
tags:
- Deel
- subpackage_groups
created: '2026-05-19'
modified: '2026-05-19'
binds:
- namespace: env
keys:
DEEL_API_KEY: DEEL_API_KEY
capability:
consumes:
- type: http
namespace: endpoints-1-subpackage-groups
baseUri: https://api.letsdeel.com/rest/v2
description: Endpoints — subpackage_groups business capability. Self-contained, no shared references.
resources:
- name: groups
path: /groups
operations:
- name: creategroup
method: POST
description: Create a group
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: Authorization
in: header
type: string
description: '## Authentication'
required: true
- name: body
in: body
type: object
description: Request body (JSON).
required: false
- name: getgroups
method: GET
description: Return list of groups
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: limit
in: query
type: integer
description: The maximum number of groups to return (between 1 and 100)
- name: sort_order
in: query
type: string
description: Sort the results in ascending (ASC) or descending (DESC) order based on the group name.
- name: cursor
in: query
type: string
description: The encoded cursor for paginated results. This is an opaque string that allows fetching the next set
of results.
- name: include_archived_groups
in: query
type: boolean
description: Include archived groups (soft deleted records). Defaults to `true`.
- name: external_metadata
in: query
type: string
description: Extra information about the group.
- name: Authorization
in: header
type: string
description: '## Authentication'
required: true
- name: groups-id
path: /groups/{id}
operations:
- name: deletegroup
method: DELETE
description: Delete a group
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: id
in: path
type: string
required: true
- name: Authorization
in: header
type: string
description: '## Authentication'
required: true
- name: updategroup
method: PATCH
description: Edit a group
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: id
in: path
type: string
required: true
- name: Authorization
in: header
type: string
description: '## Authentication'
required: true
- name: body
in: body
type: object
description: Request body (JSON).
required: false
- name: groups-id-clone
path: /groups/{id}/clone
operations:
- name: clonegroup
method: POST
description: Clone a Group
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: id
in: path
type: string
description: Unique identifier of the group to be cloned.
required: true
- name: Authorization
in: header
type: string
description: '## Authentication'
required: true
- name: body
in: body
type: object
description: Request body (JSON).
required: false
authentication:
type: bearer
token: '{{env.DEEL_API_KEY}}'
exposes:
- type: rest
namespace: endpoints-1-subpackage-groups-rest
port: 8080
description: REST adapter for Endpoints — subpackage_groups. One Spectral-compliant resource per consumed operation, prefixed
with /v1.
resources:
- path: /v1/groups
name: groups
description: REST surface for groups.
operations:
- method: POST
name: creategroup
description: Create a group
call: endpoints-1-subpackage-groups.creategroup
with:
Authorization: rest.Authorization
body: rest.body
outputParameters:
- type: object
mapping: $.
- method: GET
name: getgroups
description: Return list of groups
call: endpoints-1-subpackage-groups.getgroups
with:
limit: rest.limit
sort_order: rest.sort_order
cursor: rest.cursor
include_archived_groups: rest.include_archived_groups
external_metadata: rest.external_metadata
Authorization: rest.Authorization
outputParameters:
- type: object
mapping: $.
- path: /v1/groups/{id}
name: groups-id
description: REST surface for groups-id.
operations:
- method: DELETE
name: deletegroup
description: Delete a group
call: endpoints-1-subpackage-groups.deletegroup
with:
id: rest.id
Authorization: rest.Authorization
outputParameters:
- type: object
mapping: $.
- method: PATCH
name: updategroup
description: Edit a group
call: endpoints-1-subpackage-groups.updategroup
with:
id: rest.id
Authorization: rest.Authorization
body: rest.body
outputParameters:
- type: object
mapping: $.
- path: /v1/groups/{id}/clone
name: groups-id-clone
description: REST surface for groups-id-clone.
operations:
- method: POST
name: clonegroup
description: Clone a Group
call: endpoints-1-subpackage-groups.clonegroup
with:
id: rest.id
Authorization: rest.Authorization
body: rest.body
outputParameters:
- type: object
mapping: $.
- type: mcp
namespace: endpoints-1-subpackage-groups-mcp
port: 9090
transport: http
description: MCP adapter for Endpoints — subpackage_groups. One tool per consumed operation, routed inline through this
capability's consumes block.
tools:
- name: create-group
description: Create a group
hints:
readOnly: false
destructive: false
idempotent: false
call: endpoints-1-subpackage-groups.creategroup
with:
Authorization: tools.Authorization
body: tools.body
outputParameters:
- type: object
mapping: $.
- name: return-list-groups
description: Return list of groups
hints:
readOnly: true
destructive: false
idempotent: true
call: endpoints-1-subpackage-groups.getgroups
with:
limit: tools.limit
sort_order: tools.sort_order
cursor: tools.cursor
include_archived_groups: tools.include_archived_groups
external_metadata: tools.external_metadata
Authorization: tools.Authorization
outputParameters:
- type: object
mapping: $.
- name: delete-group
description: Delete a group
hints:
readOnly: false
destructive: true
idempotent: true
call: endpoints-1-subpackage-groups.deletegroup
with:
id: tools.id
Authorization: tools.Authorization
outputParameters:
- type: object
mapping: $.
- name: edit-group
description: Edit a group
hints:
readOnly: false
destructive: false
idempotent: true
call: endpoints-1-subpackage-groups.updategroup
with:
id: tools.id
Authorization: tools.Authorization
body: tools.body
outputParameters:
- type: object
mapping: $.
- name: clone-group
description: Clone a Group
hints:
readOnly: false
destructive: false
idempotent: false
call: endpoints-1-subpackage-groups.clonegroup
with:
id: tools.id
Authorization: tools.Authorization
body: tools.body
outputParameters:
- type: object
mapping: $.