directory_csv_invalid
Developer and IT administrator messages for directory_csv_invalid.
Since API version 1.0.
| Field | Value |
|---|---|
| Type | invalid_request |
| Status | 400 |
| Surfaces | api |
| Retryable | No |
What it means
Section titled “What it means”The CSV file was refused and nothing in the directory changed. The message lists up to 20 problems in words, and details lists the same problems one per item, with the row (1 is the header row; 0 is the file as a whole), the column when there is one, and what is wrong.
Likely causes
Section titled “Likely causes”- The header row has an unknown or duplicate column, or misses
external_id, or has neitheruser_namenoremail. - A row has no
external_id, an invalid email address, or anactivevalue other than true or false. - The file is not UTF-8, is larger than the limit, or has a malformed row (for example an unclosed quote).
How to fix it
Section titled “How to fix it”For developers
Section titled “For developers”- Read
detailsto show each problem next to its row and column in your own upload screen; don’t parsemessage. - Fix every listed row and upload the whole file again; a file is applied all at once or not at all.
- Use
dry_run=trueto check a file without changing the directory.
For IT administrators
Section titled “For IT administrators”- Fix the rows the error lists, save the file as UTF-8 CSV and upload it again.
Example
Section titled “Example”The API answers HTTP 400. details carries one item per problem:
{ "error": { "type": "invalid_request", "code": "directory_csv_invalid", "message": "row 1 departmnt: unknown column; row 4 email: not an email address", "param": "body", "doc_url": "https://docs.ohauthcat.com/errors/directory_csv_invalid", "request_id": "req_01J9Z3K5V7W8X9Y0Z1A2B3C4D5", "details": [ { "row": 1, "column": "departmnt", "problem": "unknown column" }, { "row": 4, "column": "email", "problem": "not an email address" } ] }}Developer message
Section titled “Developer message”The CSV file is invalid; message names up to 20 problems by row and column
IT administrator message
Section titled “IT administrator message”The CSV file has errors. Fix the rows listed and upload it again
Translated IT administrator messages
Section titled “Translated IT administrator messages”The hosted portal shows these machine translations, which native speakers have not reviewed yet. Placeholders and identity provider console labels stay in English.
de: Die CSV-Datei enthält Fehler. Korrigieren Sie die aufgeführten Zeilen und laden Sie sie erneut hoches: El archivo CSV tiene errores. Corrija las filas indicadas y vuelva a subirlofr: Le fichier CSV contient des erreurs. Corrigez les lignes indiquées et importez-le à nouveauja: CSV ファイルにエラーがあります。表示された行を修正して、もう一度アップロードしてくださいpt-BR: O arquivo CSV tem erros. Corrija as linhas indicadas e envie-o novamente