Folder

Create Folder

Creates a folder for the given name and returns folderId with success message.

SecuritybearerAuth
Request
Request Body schema: application/json
required

To create a folder, folderName is required and parentFolderId is optional.

name
required
string [ 1 .. 255 ] characters

name

parentFolderId
integer <int32> >= 1

parentFolderId

Responses
201

Created

400

Bad Request

401

Unauthorized

500

Internal Server Error

post/folders
Request samples
application/json
{
  • "name": "SCA",
  • "parentFolderId": 1
}

Get Folder By Id

Get existing folder by folderId

SecuritybearerAuth
Request
path Parameters
folderId
required
integer <int32> >= 1
Responses
200

OK

400

Bad Request

401

Unauthorized

404

Not Found

500

Internal Server Error

get/folders/{folderId}

Update folder details

Update folder details for the given folderId.

SecuritybearerAuth
Request
path Parameters
folderId
required
integer <int32> >= 1
Request Body schema: application/json
required

Update details of a folder.

name
required
string [ 1 .. 255 ] characters

name

parentFolderId
integer <int32> >= 1

parentFolderId

Responses
200

OK

400

Bad Request

401

Unauthorized

404

Not Found

500

Internal Server Error

put/folders/{folderId}
Request samples
application/json
{
  • "name": "SCA",
  • "parentFolderId": 1
}

Delete a folder

Deleting a folder will delete all subfolders, contained projects will be associated wih the parent folder(Projects(0)).

SecuritybearerAuth
Request
path Parameters
folderId
required
integer <int64> >= 1

ID of the folder

Example: 1
Responses
200

OK

400

Bad Request

401

Unauthorized

404

Not Found

500

Internal Server Error

delete/folders/{folderId}

Get folders based on the name provided

Return folders based on the name provided

SecuritybearerAuth
Request
query Parameters
folderName
string

Search happens based on the name given

offset
integer <int64> >= 1
Default: 1

Index of the page to start with

limit
integer <int64> >= 1
Default: 25

Number of records to fetch

Responses
200

OK

400

Bad Request

401

Unauthorized

500

Internal Server Error

get/folders/search