API Reference
Log In
API Reference

Bulk import departments and primary memberships from CSV

Accepts multipart/form-data with a file field named 'file'. Header: email,department_path[,is_primary] (org_unit_path is accepted as a silent back-compat alias for department_path). department_path is slash-separated unit names from root (e.g. Engineering/Platform/Payments); missing units are created. Emails resolve to directory people (created when missing, source=csv); no operational user is ever created. dryRun=true runs full validation with zero writes. By default an import only adds and moves people; removeMissing=true also ends the assignment of everyone not in the file.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string
required

Team (organization) identifier to import into

boolean
Defaults to false

When true, validates and reports without writing any data

boolean
Defaults to false

When true, the file is the full list: everyone with an open CSV or manual assignment who is not in the file has it ended. Their earlier usage stays on their department; nobody is deleted. Skipped when any row fails

Body Params
file
required
Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
*/*