Skip to main content
POST
Create a folder

Authorizations

Authorization
string
header
required

A Parley API key.

Body

application/json
name
string
required

Folder name. If a folder with this name is already there, a number is appended, as in "Evidence (2)".

Required string length: 1 - 255
projectId
string

Create it in this project's files. Pass exactly one of projectId, accountId, contactId, intakeId, or library.

Minimum string length: 1
accountId
string

Create it in this account's files. Pass exactly one of projectId, accountId, contactId, intakeId, or library.

Minimum string length: 1
contactId
string

Create it in this contact's files. Pass exactly one of projectId, accountId, contactId, intakeId, or library.

Minimum string length: 1
intakeId
string

Create it in this intake's files. Pass exactly one of projectId, accountId, contactId, intakeId, or library.

Minimum string length: 1
library
any

true for the organization's Library. Pass exactly one of projectId, accountId, contactId, intakeId, or library.

folderId
string

Put it inside this folder. Omit for the top level.

Minimum string length: 1

Response

Created.

A file or a folder, told apart by type.

type
any
required
id
string
required

The file or folder ID.

Minimum string length: 1
name
string
required

The name, including any file extension.

location
object
required

Whose files these are: a project's, an account's, a contact's, or an intake's, or the organization's Library.

folder
object | null
required

The folder it is in, or null at the top level.

createdAt
string<date-time>
required

When it was added.

updatedAt
string<date-time>
required

When it was last updated, including processing, renames, and moves.

mediaType
string | null
required

The file's media type, such as application/pdf, from its extension, or null when the extension isn't recognized.

status
enum<string>
required

Whether Parley has extracted the file's text: pending (queued), processing, ready (its text can be read), or failed (download it instead).

Available options:
pending,
processing,
ready,
failed