> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tangoanalytics.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Drop HR file at SFTP path



## OpenAPI

````yaml /tango_space/integrations/guides/space-hr-inbound-file.yaml post /inbound/hr
openapi: 3.1.0
info:
  title: Tango Space HR Inbound — File
  version: '2.2'
  description: |
    SFTP file-based inbound. Client drops a pipe-delimited file of Person/HR
    records on Tango's SFTP server. Tango processes the file and updates
    People in Space Management.

    Tilde-preservation convention: send `~` in any string field to indicate
    "retain the existing value" (do not overwrite). For date fields, send
    `01/01/1800`. For numeric fields, send `0.0001`. These sentinels prevent
    null-out updates.

    Upsert key: `PERSON_NUMBER`.
  x-direction: inbound
  x-source: Client System
  x-destination: Tango
  x-transport: sftp
  x-file-format: pipe-delimited text (.txt)
  x-file-naming-convention: '{ClientName}_HR_MMDDYYYYHHMMSS.txt'
  x-retention-sentinels:
    string: '~'
    date: 01/01/1800
    number: '0.0001'
servers:
  - url: sftp://sftp.tangoanalytics.com
    description: Production SFTP
    x-environment: production
    x-path: /inbound/hr
  - url: sftp://sftpdev.tangoanalytics.com
    description: Test SFTP (SIT/UAT)
    x-environment: test
    x-path: /inbound/hr
security:
  - sftpUserPassword: []
tags:
  - name: HR Inbound File
paths:
  /inbound/hr:
    post:
      tags:
        - HR Inbound File
      summary: Drop HR file at SFTP path
      operationId: deliverHrInboundFile
      requestBody:
        required: true
        content:
          text/plain:
            schema:
              type: string
              format: binary
              x-record-schema:
                $ref: '#/components/schemas/HrRow'
      responses:
        '200':
          description: File received.
components:
  securitySchemes:
    sftpUserPassword:
      type: http
      scheme: basic

````