---
title: "Import dotAuth AppSecrets"
method: POST
path: "/api/v1/dotauth/import"
tags: ["dotAuth"]
---

# Import dotAuth AppSecrets

`POST /api/v1/dotauth/import`

## Request

- Base URL: `https://docs.anzworldline-solutions.com.au`
- URL: `https://docs.anzworldline-solutions.com.au/api/v1/dotauth/import`
- Auth: none declared
- TypeScript: <https://skmtc.dev/anzworldline-solutions/apis/dotcms-rest-api/docs/api/v1/dotauth/import/post.ts> (a function with typed inputs; its response is checked against the schema)

Imports an encrypted Apps export file containing only OAuth/OIDC, SAML, and headless dotAuth AppSecrets.

## Request body `multipart/form-data`

- FormDataMultiPart
  - `contentDisposition` ContentDisposition
    - `type` string
    - `parameters` object
    - `fileName` string
    - `creationDate` string, date-time
    - `modificationDate` string, date-time
    - `readDate` string, date-time
    - `size` integer
  - `entity` object
  - `headers` object
  - `mediaType` object
    - `type` string
    - `subtype` string
    - `parameters` object
    - `wildcardType` boolean
    - `wildcardSubtype` boolean
  - `messageBodyWorkers` MessageBodyWorkers
  - `parent` MultiPart
    - `contentDisposition` ContentDisposition
      - `type` string
      - `parameters` object
      - `fileName` string
      - `creationDate` string, date-time
      - `modificationDate` string, date-time
      - `readDate` string, date-time
      - `size` integer
    - `entity` object
    - `headers` object
    - `mediaType` object
      - `type` string
      - `subtype` string
      - `parameters` object
      - `wildcardType` boolean
      - `wildcardSubtype` boolean
    - `messageBodyWorkers` MessageBodyWorkers
    - `parent` MultiPart (recursive)
    - `providers` object
    - `bodyParts` BodyPart[]
      - `contentDisposition` ContentDisposition
        - `type` string
        - `parameters` object
        - `fileName` string
        - `creationDate` string, date-time
        - `modificationDate` string, date-time
        - `readDate` string, date-time
        - `size` integer
      - `entity` object
      - `headers` object
      - `mediaType` object
        - `type` string
        - `subtype` string
        - `parameters` object
        - `wildcardType` boolean
        - `wildcardSubtype` boolean
      - `messageBodyWorkers` MessageBodyWorkers
      - `parent` MultiPart (recursive)
      - `providers` object
      - `parameterizedHeaders` object
    - `parameterizedHeaders` object
  - `providers` object
  - `bodyParts` BodyPart[]
    - `contentDisposition` ContentDisposition
      - `type` string
      - `parameters` object
      - `fileName` string
      - `creationDate` string, date-time
      - `modificationDate` string, date-time
      - `readDate` string, date-time
      - `size` integer
    - `entity` object
    - `headers` object
    - `mediaType` object
      - `type` string
      - `subtype` string
      - `parameters` object
      - `wildcardType` boolean
      - `wildcardSubtype` boolean
    - `messageBodyWorkers` MessageBodyWorkers
    - `parent` MultiPart
      - `contentDisposition` ContentDisposition
        - `type` string
        - `parameters` object
        - `fileName` string
        - `creationDate` string, date-time
        - `modificationDate` string, date-time
        - `readDate` string, date-time
        - `size` integer
      - `entity` object
      - `headers` object
      - `mediaType` object
        - `type` string
        - `subtype` string
        - `parameters` object
        - `wildcardType` boolean
        - `wildcardSubtype` boolean
      - `messageBodyWorkers` MessageBodyWorkers
      - `parent` MultiPart (recursive)
      - `providers` object
      - `bodyParts` BodyPart[]
      - `parameterizedHeaders` object
    - `providers` object
    - `parameterizedHeaders` object
  - `fields` object
  - `parameterizedHeaders` object

## Response `200`

Import succeeded

- object: Import result with count of imported secrets

## Other responses

- `400`: Invalid password, empty file, or non-dotAuth secrets in file
- `401`: Authentication required
- `403`: Admin access required
- `500`: Internal server error

## Changes

- **2026-10-30** `4fd8e917d458`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/anzworldline-solutions/apis/dotcms-rest-api/changes/api/v1/dotauth/import/post.md)

---

[API](https://skmtc.dev/anzworldline-solutions/apis/dotcms-rest-api.md) - [All operations](https://skmtc.dev/anzworldline-solutions/apis/dotcms-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/anzworldline-solutions/apis/dotcms-rest-api/revisions/4fd8e917d458?raw)