Update an employee record (partial update)

Only include fields to change. Returns the full updated employee.

Requires employees:write scope. Requires Idempotency-Key header.

Updatable fields: name, salary_usd_cents, employment_type, payment_schedule, stablecoin, network, contract_start_date, contract_end_date, status (ACTIVE/INACTIVE only).

Not updatable via API: email, role, wallet_address (employee sets their own).

Authorization

apiKey

AuthorizationBearer <token>

API key: Authorization: Bearer mpk_live_<key>

In: header

Path Parameters

employee_id*string

Employee/user identifier

Header Parameters

Idempotency-Key*string

UUID v4. Required on all write operations. Prevents duplicate execution on retry.

Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

name?string

salary_usd_cents?integer

employment_type?string

FTE: Full-time employee. Fixed monthly salary.
CONTRACTOR: Independent contractor. Variable payments.
CONSULTANT: External consultant.

Value in"FTE" | "CONTRACTOR" | "CONSULTANT"

payment_schedule?string

stablecoin?string

USDC: USD Coin (Circle)
USDT: Tether USD

Value in"USDC" | "USDT"

network?string

ETHEREUM: Ethereum mainnet (L1). Explorer: etherscan.io
BASE: Base L2 (Coinbase). Explorer: basescan.org
BSC: BNB Smart Chain. Explorer: bscscan.com

Value in"ETHEREUM" | "BASE" | "BSC"

contract_start_date?string

Formatdate

contract_end_date?string

Formatdate

status?string

Can only toggle between ACTIVE and INACTIVE

Value in"ACTIVE" | "INACTIVE"

Response Body

curl -X PATCH "https://motivation-money.vercel.app/api/v1/employees/usr_emp456" \  -H "Idempotency-Key: 7f3c4d2a-8b1e-4f6a-9c2d-1a5b8e3f7d4c" \  -H "Content-Type: application/json" \  -d '{}'

Empty