Deel EOR API — Hiring

naftiko: 1.0.0-alpha2
info:
  label: Deel EOR API — Hiring
  description: Self-contained Naftiko capability for Deel EOR contract creation and the three-party quote/sign flow.
  tags:
  - Deel
  - EOR
  - Hiring
  - HR
  created: '2026-05-25'
  modified: '2026-05-25'
binds:
- namespace: env
  keys:
    DEEL_API_TOKEN: DEEL_API_TOKEN
capability:
  consumes:
  - type: http
    namespace: eor-hiring
    baseUri: https://api.letsdeel.com/rest/v2
    description: Deel EOR Hiring capability.
    resources:
    - name: eor-contracts
      path: /eor/contracts
      operations:
      - name: createEorContract
        method: POST
        description: Create an EOR contract draft.
        outputRawFormat: json
        outputParameters:
        - { name: result, type: object, value: $. }
        inputParameters:
        - { name: body, in: body, type: object, required: true }
        - { name: Idempotency-Key, in: header, type: string, required: false }
    - name: eor-contract-accept-quote
      path: /eor/contracts/{contract_id}/accept-quote
      operations:
      - name: acceptEorQuote
        method: POST
        description: Accept the EOR contract quote (client-side three-party signature).
        outputRawFormat: json
        outputParameters:
        - { name: result, type: object, value: $. }
        inputParameters:
        - { name: contract_id, in: path, type: string, required: true }
        - { name: body, in: body, type: object, required: true }
    - name: eor-contract-cancel
      path: /eor/contracts/{contract_id}/cancel
      operations:
      - name: cancelEorContract
        method: POST
        description: Cancel an EOR contract before activation.
        outputRawFormat: json
        outputParameters:
        - { name: result, type: object, value: $. }
        inputParameters:
        - { name: contract_id, in: path, type: string, required: true }
        - { name: body, in: body, type: object, required: false }
    authentication:
      type: bearer
      value: '{{env.DEEL_API_TOKEN}}'
      placement: header
  exposes:
  - type: rest
    namespace: eor-hiring-rest
    port: 8080
    description: REST adapter for Deel EOR Hiring.
    resources:
    - path: /v1/eor/contracts
      name: eor-contracts
      description: REST surface for EOR contracts.
      operations:
      - method: POST
        name: createEorContract
        description: Create EOR contract.
        call: eor-hiring.createEorContract
        with: { body: rest.body, Idempotency-Key: rest.header.idempotency_key }
    - path: /v1/eor/contracts/{contract_id}/accept-quote
      name: eor-contract-accept-quote
      description: Accept quote.
      operations:
      - method: POST
        name: acceptEorQuote
        description: Accept the EOR quote.
        call: eor-hiring.acceptEorQuote
        with: { contract_id: rest.path.contract_id, body: rest.body }
    - path: /v1/eor/contracts/{contract_id}/cancel
      name: eor-contract-cancel
      description: Cancel EOR contract.
      operations:
      - method: POST
        name: cancelEorContract
        description: Cancel the EOR contract.
        call: eor-hiring.cancelEorContract
        with: { contract_id: rest.path.contract_id, body: rest.body }