naftiko: 1.0.0-alpha2 info: label: Unified.to API — group description: 'Unified.to API — group. 18 operations. Lead operation: List All Groups. Self-contained Naftiko capability covering one Unified To business surface.' tags: - Unified To - group 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-group baseUri: https://api.unified.to description: Unified.to API — group business capability. Self-contained, no shared references. resources: - name: ads-connection_id-group path: /ads/{connection_id}/group operations: - name: listadsgroups method: GET description: List All Groups 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: org_id in: query type: string description: The org ID to filter by (reference to AdsOrganization) - name: campaign_id in: query type: string description: The campaign ID to filter by - name: parent_id in: query type: string description: The parent ID to filter by - name: io_id in: query type: string description: The IO ID to filter by - name: start_gte in: query type: string description: The start date to filter by (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format) - name: end_lt in: query type: string description: The end date to filter by (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format) - 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: createadsgroup method: POST description: Create a Group 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: ads-connection_id-group-id path: /ads/{connection_id}/group/{id} operations: - name: removeadsgroup method: DELETE description: Remove a Group 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 Group required: true - name: getadsgroup method: GET description: Retrieve a Group 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 Group required: true - name: patchadsgroup method: PATCH description: Update a Group 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 Group required: true - name: body in: body type: object description: Request body (JSON). required: true - name: updateadsgroup method: PUT description: Update a Group 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 Group required: true - name: body in: body type: object description: Request body (JSON). required: true - name: hris-connection_id-group path: /hris/{connection_id}/group operations: - name: listhrisgroups method: GET description: List All Groups 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: company_id in: query type: string description: The company ID to filter by (reference to HrisCompany) - name: type in: query type: string description: The type 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: createhrisgroup method: POST description: Create a Group 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: hris-connection_id-group-id path: /hris/{connection_id}/group/{id} operations: - name: removehrisgroup method: DELETE description: Remove a Group 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 Group required: true - name: gethrisgroup method: GET description: Retrieve a Group 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 Group required: true - name: patchhrisgroup method: PATCH description: Update a Group 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 Group required: true - name: body in: body type: object description: Request body (JSON). required: true - name: updatehrisgroup method: PUT description: Update a Group 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 Group required: true - name: body in: body type: object description: Request body (JSON). required: true - name: scim-connection_id-groups path: /scim/{connection_id}/groups operations: - name: listscimgroups method: GET description: List Groups 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: createscimgroups method: POST description: Create Group outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - 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-groups-id path: /scim/{connection_id}/groups/{id} operations: - name: removescimgroups method: DELETE description: Delete Group 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 Group required: true - name: getscimgroups method: GET description: Get Group 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 Group required: true - name: patchscimgroups method: PATCH description: Update Group 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 Group required: true - name: body in: body type: object description: Request body (JSON). required: true - name: updatescimgroups method: PUT description: Update Group 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 Group 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-group-rest port: 8080 description: REST adapter for Unified.to API — group. One Spectral-compliant resource per consumed operation, prefixed with /v1. resources: - path: /v1/ads/{connection-id}/group name: ads-connection-id-group description: REST surface for ads-connection_id-group. operations: - method: GET name: listadsgroups description: List All Groups call: full-group.listadsgroups with: limit: rest.limit offset: rest.offset updated_gte: rest.updated_gte sort: rest.sort order: rest.order query: rest.query org_id: rest.org_id campaign_id: rest.campaign_id parent_id: rest.parent_id io_id: rest.io_id start_gte: rest.start_gte end_lt: rest.end_lt fields: rest.fields raw: rest.raw connection_id: rest.connection_id outputParameters: - type: object mapping: $. - method: POST name: createadsgroup description: Create a Group call: full-group.createadsgroup with: fields: rest.fields raw: rest.raw connection_id: rest.connection_id body: rest.body outputParameters: - type: object mapping: $. - path: /v1/ads/{connection-id}/group/{id} name: ads-connection-id-group-id description: REST surface for ads-connection_id-group-id. operations: - method: DELETE name: removeadsgroup description: Remove a Group call: full-group.removeadsgroup with: connection_id: rest.connection_id id: rest.id outputParameters: - type: object mapping: $. - method: GET name: getadsgroup description: Retrieve a Group call: full-group.getadsgroup with: fields: rest.fields raw: rest.raw connection_id: rest.connection_id id: rest.id outputParameters: - type: object mapping: $. - method: PATCH name: patchadsgroup description: Update a Group call: full-group.patchadsgroup 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: updateadsgroup description: Update a Group call: full-group.updateadsgroup with: fields: rest.fields raw: rest.raw connection_id: rest.connection_id id: rest.id body: rest.body outputParameters: - type: object mapping: $. - path: /v1/hris/{connection-id}/group name: hris-connection-id-group description: REST surface for hris-connection_id-group. operations: - method: GET name: listhrisgroups description: List All Groups call: full-group.listhrisgroups with: limit: rest.limit offset: rest.offset updated_gte: rest.updated_gte sort: rest.sort order: rest.order query: rest.query company_id: rest.company_id type: rest.type fields: rest.fields raw: rest.raw connection_id: rest.connection_id outputParameters: - type: object mapping: $. - method: POST name: createhrisgroup description: Create a Group call: full-group.createhrisgroup with: fields: rest.fields raw: rest.raw connection_id: rest.connection_id body: rest.body outputParameters: - type: object mapping: $. - path: /v1/hris/{connection-id}/group/{id} name: hris-connection-id-group-id description: REST surface for hris-connection_id-group-id. operations: - method: DELETE name: removehrisgroup description: Remove a Group call: full-group.removehrisgroup with: connection_id: rest.connection_id id: rest.id outputParameters: - type: object mapping: $. - method: GET name: gethrisgroup description: Retrieve a Group call: full-group.gethrisgroup with: fields: rest.fields raw: rest.raw connection_id: rest.connection_id id: rest.id outputParameters: - type: object mapping: $. - method: PATCH name: patchhrisgroup description: Update a Group call: full-group.patchhrisgroup 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: updatehrisgroup description: Update a Group call: full-group.updatehrisgroup with: fields: rest.fields raw: rest.raw connection_id: rest.connection_id id: rest.id body: rest.body outputParameters: - type: object mapping: $. - path: /v1/scim/{connection-id}/groups name: scim-connection-id-groups description: REST surface for scim-connection_id-groups. operations: - method: GET name: listscimgroups description: List Groups call: full-group.listscimgroups 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: createscimgroups description: Create Group call: full-group.createscimgroups with: connection_id: rest.connection_id body: rest.body outputParameters: - type: object mapping: $. - path: /v1/scim/{connection-id}/groups/{id} name: scim-connection-id-groups-id description: REST surface for scim-connection_id-groups-id. operations: - method: DELETE name: removescimgroups description: Delete Group call: full-group.removescimgroups with: connection_id: rest.connection_id id: rest.id outputParameters: - type: object mapping: $. - method: GET name: getscimgroups description: Get Group call: full-group.getscimgroups with: connection_id: rest.connection_id id: rest.id outputParameters: - type: object mapping: $. - method: PATCH name: patchscimgroups description: Update Group call: full-group.patchscimgroups with: connection_id: rest.connection_id id: rest.id body: rest.body outputParameters: - type: object mapping: $. - method: PUT name: updatescimgroups description: Update Group call: full-group.updatescimgroups with: connection_id: rest.connection_id id: rest.id body: rest.body outputParameters: - type: object mapping: $. - type: mcp namespace: full-group-mcp port: 9090 transport: http description: MCP adapter for Unified.to API — group. One tool per consumed operation, routed inline through this capability's consumes block. tools: - name: list-all-groups description: List All Groups hints: readOnly: true destructive: false idempotent: true call: full-group.listadsgroups with: limit: tools.limit offset: tools.offset updated_gte: tools.updated_gte sort: tools.sort order: tools.order query: tools.query org_id: tools.org_id campaign_id: tools.campaign_id parent_id: tools.parent_id io_id: tools.io_id start_gte: tools.start_gte end_lt: tools.end_lt fields: tools.fields raw: tools.raw connection_id: tools.connection_id outputParameters: - type: object mapping: $. - name: create-group description: Create a Group hints: readOnly: false destructive: false idempotent: false call: full-group.createadsgroup with: fields: tools.fields raw: tools.raw connection_id: tools.connection_id body: tools.body outputParameters: - type: object mapping: $. - name: remove-group description: Remove a Group hints: readOnly: false destructive: true idempotent: true call: full-group.removeadsgroup with: connection_id: tools.connection_id id: tools.id outputParameters: - type: object mapping: $. - name: retrieve-group description: Retrieve a Group hints: readOnly: true destructive: false idempotent: true call: full-group.getadsgroup with: fields: tools.fields raw: tools.raw connection_id: tools.connection_id id: tools.id outputParameters: - type: object mapping: $. - name: update-group description: Update a Group hints: readOnly: false destructive: false idempotent: true call: full-group.patchadsgroup with: fields: tools.fields raw: tools.raw connection_id: tools.connection_id id: tools.id body: tools.body outputParameters: - type: object mapping: $. - name: update-group-2 description: Update a Group hints: readOnly: false destructive: false idempotent: true call: full-group.updateadsgroup 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-groups-2 description: List All Groups hints: readOnly: true destructive: false idempotent: true call: full-group.listhrisgroups with: limit: tools.limit offset: tools.offset updated_gte: tools.updated_gte sort: tools.sort order: tools.order query: tools.query company_id: tools.company_id type: tools.type fields: tools.fields raw: tools.raw connection_id: tools.connection_id outputParameters: - type: object mapping: $. - name: create-group-2 description: Create a Group hints: readOnly: false destructive: false idempotent: false call: full-group.createhrisgroup with: fields: tools.fields raw: tools.raw connection_id: tools.connection_id body: tools.body outputParameters: - type: object mapping: $. - name: remove-group-2 description: Remove a Group hints: readOnly: false destructive: true idempotent: true call: full-group.removehrisgroup with: connection_id: tools.connection_id id: tools.id outputParameters: - type: object mapping: $. - name: retrieve-group-2 description: Retrieve a Group hints: readOnly: true destructive: false idempotent: true call: full-group.gethrisgroup with: fields: tools.fields raw: tools.raw connection_id: tools.connection_id id: tools.id outputParameters: - type: object mapping: $. - name: update-group-3 description: Update a Group hints: readOnly: false destructive: false idempotent: true call: full-group.patchhrisgroup with: fields: tools.fields raw: tools.raw connection_id: tools.connection_id id: tools.id body: tools.body outputParameters: - type: object mapping: $. - name: update-group-4 description: Update a Group hints: readOnly: false destructive: false idempotent: true call: full-group.updatehrisgroup with: fields: tools.fields raw: tools.raw connection_id: tools.connection_id id: tools.id body: tools.body outputParameters: - type: object mapping: $. - name: list-groups description: List Groups hints: readOnly: true destructive: false idempotent: true call: full-group.listscimgroups 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-group-3 description: Create Group hints: readOnly: false destructive: false idempotent: false call: full-group.createscimgroups with: connection_id: tools.connection_id body: tools.body outputParameters: - type: object mapping: $. - name: delete-group description: Delete Group hints: readOnly: false destructive: true idempotent: true call: full-group.removescimgroups with: connection_id: tools.connection_id id: tools.id outputParameters: - type: object mapping: $. - name: get-group description: Get Group hints: readOnly: true destructive: false idempotent: true call: full-group.getscimgroups with: connection_id: tools.connection_id id: tools.id outputParameters: - type: object mapping: $. - name: update-group-5 description: Update Group hints: readOnly: false destructive: false idempotent: true call: full-group.patchscimgroups with: connection_id: tools.connection_id id: tools.id body: tools.body outputParameters: - type: object mapping: $. - name: update-group-6 description: Update Group hints: readOnly: false destructive: false idempotent: true call: full-group.updatescimgroups with: connection_id: tools.connection_id id: tools.id body: tools.body outputParameters: - type: object mapping: $.