---
title: "POST /resourceAlias/{alias}/children"
method: POST
path: "/resourceAlias/{alias}/children"
tags: ["postChildrenForAlias"]
---

# POST /resourceAlias/{alias}/children

`POST /resourceAlias/{alias}/children`

Prepare upload of files or create container/nested containers like "mkdir -p"

## Path parameters

- `alias` string, required

## Query parameters

- `conflictResolution` 'RENAME' | 'OVERWRITE' | 'NONE' | 'INVALID'
- `lockToken` string
- `option` 'DEFAULT' | 'METADATA' | 'MIGRATIONMETADATA' | 'ADDITIONALMETADATA' | 'WIN32PROPERTIES' | 'PARENTS' | 'PROPERTIES' | 'DOWNLOAD' | 'INTERNALDOWNLOAD' | 'UPLOAD' | 'INTERNALUPLOAD' | 'OPEN' | 'SHARES' | 'THUMBNAILS' | 'DISPLAYRESOURCE' | 'SYNC' | 'INVALID' | 'FULLPATH' | 'TAGS'

## Headers

- `cookie` string
- `If-Match` string

## Request body

- object[]
  - `forceOverwrite` boolean
  - `ovewrite` boolean
  - `path` string, required
  - `resourceType` 'CONTAINER' | 'ALIASCONTAINER' | 'FILE', required
  - `sha256` string
  - `size` integer
  - `uploadType` 'SIMPLE' | 'SIMPLECHUNK' | 'CHUNKED' | 'URI' | 'FORM'
  - `properties` ResourceCreationPropertiesModel
    - `ui:win32` UiWin32
      - `readOnly` boolean
      - `hidden` boolean
      - `system` boolean
      - `creationMillis` integer
      - `lastModificationMillis` integer
      - `lastAccessMillis` integer
    - `ui:share` UiShareModel
      - `share` ShareModel[]
        - `ownerName` string
        - `name` string
        - `expirationMillis` integer
        - `resourcePermission` SharePermission
          - `readable` boolean
          - `writable` boolean
          - `deletable` boolean
          - `notificationEnabled` boolean
        - `hasPin` boolean

## Response `207`

MULTI STATUS

## Other responses

- `400` — BAD REQUEST, No path provided, path too long or path contains illegal characters
- `409` — CONFLICT, file resource already exists (inside of the multistatus)
- `412` — PRECONDITION, FAILED non-matching Etag of 'If-Match' Header
- `423` — LOCKED, Resource or parent resource is locked (inside of the multistatus)
- `507` — INSUFFICIENT STORAGE, insufficient storage or quotas exceeded (inside of the multistatus)

## Changes

- **2022-04-21** `db4cab1e9027` — 1 breaking, 2 info
  - the `items/properties` request property type/format changed from `array`/`` to ``/``
  - added the new optional request property `items/properties/ui:share`
  - added the new optional request property `items/properties/ui:win32`
- **2022-04-14** `c408b9cb9e1a` — 1 info
  - added the new optional request property `items/properties`
- **2021-11-05** `8f8578e5d4c5` — 1 info
  - added the optional property `additionalProperties/entity/conflicting/ui:fs/children/items/ui:share` to the response with the `207` status
- **2021-10-25** `ef9761927b5f` — 2 breaking
  - removed the success response with the status `200`
  - removed the success response with the status `201`
- **2021-10-18** `75899b69a09a` — 1 breaking, 1 warning, 2 info
  - the response's body type/format changed from `object`/`` to `string`/`` for status `207`
  - removed the request property `items/properties`
  - added the success response with the status `200`
  - added the success response with the status `201`

[Change history](https://skmtc.dev/iterate-ch/apis/restfs/changes/resourceAlias/:alias/children/post.md)

---

[API](https://skmtc.dev/iterate-ch/apis/restfs.md) · [All operations](https://skmtc.dev/iterate-ch/apis/restfs/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/iterate-ch/restfs/revisions/517e17452ca3/schema)