Sign in

v56

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-014121451.1 MB
People

Upload employment evidence

Upload employment evidence in Comp AI. Invite and manage workforce members, training status, device compliance, email preferences, and employee evidence records.

post/v1/people/{id}/employment-evidence/{eventType}

Path parameters

idstring required
Example:mem_abc123def456

Member ID

eventType'onboard' | 'offboard' required

Request body

fileNamestring required

Name of the file

fileTypestring required

MIME type of the file

fileDatastring

Base64-encoded file contents. For the web UI / direct callers. AI/MCP clients should instead upload via /v1/uploads/presign (purpose=attachment) and pass s3Key — base64 through an LLM is impractically slow and times out. Provide exactly one of fileData or s3Key.

s3Keystring

Key of a file already uploaded via /v1/uploads/presign (purpose=attachment). The server fetches the bytes from storage — no base64 needed. Provide exactly one of fileData or s3Key.

descriptionstring

Description of the attachment

userIdstring

User ID of the user uploading the attachment (required for API key auth, ignored for JWT auth)

Example request

{
  "fileName": "document.pdf",
  "fileType": "application/pdf",
  "fileData": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8/5+hHgAHggJ/PchI7wAAAABJRU5ErkJggg==",
  "s3Key": "org_abc123/uploads/attachment/1700000000000-rbac-matrix.xlsx",
  "description": "Meeting notes from Q4 planning session",
  "userId": "usr_abc123def456"
}