# Folders

Use the following endpoint to manage folders in customer accounts.

# Quick reference

Type	Resource	Description
GET	/api/managed_users/:managed_user_id/folders	List folders.
GET	/api/managed_users/:managed_user_id/projects	List projects.
POST	/api/managed_users/:managed_user_id/folders	Create a folder.

# List folders

Lists all folders in a customer account.

GET /api/managed_user_id/:managed_user_id/folders

# URL Parameters

Name	Type	Description
managed_user_id	string required	Workato Embedded customer Account ID/External ID. External ID must be prefixed with an E(eg: EA2300) and the resulting ID should be URL encoded.

# Query Parameters

Name	Type	Description
parent_id	string	Parent folder ID. Defaults to Home folder.
page	integer	Page number. Defaults to 1.
per_page	integer	Page size. Defaults to 100 (maximum is 100).

# Sample request

curl  -X GET 'https://www.workato.com/api/managed_users/1199/folders?parent_id=12323' \
      -H 'Authorization: Bearer <api_token>'
      -H 'Content-Type: application/json' \

# Response

{
    "result": [
        {
            "id": 1789,
            "name": "Netsuite production",
            "parent_id": 4515,
            "created_at": "2020-07-16T10:49:53.337-07:00",
            "updated_at": "2020-07-16T10:49:53.347-07:00"
        }
    ]
}

# List projects

Lists all projects. Projects are top level folders that normally encompass a single use case.

GET /api/managed_user_id/:managed_user_id/projects

# URL Parameters

Name	Type	Description
page	integer	Page number. Defaults to 1.
per_page	integer	Page size. Defaults to 100 (maximum is 100).

# Sample request

curl  -X GET 'https://www.workato.com/api/managed_user_id/:managed_user_id/projects' \
      -H 'Authorization: Bearer <api_token>'
      -H 'Content-Type: application/json' \

# Response

{
    "result": [
        {
            "id": 649122,
            "description": "Coupa to Netsuite automations",
            "folder_id": 1563029,
            "name": "Procure to Pay"
        },
        {
            "id": 604202,
            "description": "Salesforce to Netsuite automations",
            "folder_id": 1486330,
            "name": "Order to Cash"
        },
    ]
}

# Create folder

Creates a new folder in the specified parent folder. If no parent folder ID is specified, the folder created will be a top level folder (in the Home folder).

POST /api/managed_users/:managed_user_id/folders

# URL Parameters

Name	Type	Description
managed_user_id	string required	Workato Embedded customer Account ID/External ID. External ID must be prefixed with an E(eg: EA2300) and the resulting ID should be URL encoded.

# Payload

Name	Type	Description
name	string required	Name of the folder.
parent_id	string	Parent folder ID. Defaults to Home folder.

# Sample request

curl  -X POST https://www.workato.com/api/managed_users/1892/folders \
      -H 'Authorization: Bearer <api_token>'
      -H 'Content-Type: application/json' \
      -d  '{
            "name": "Salesforce folder"
          }'

# Response

{
  "id": 3498583,
}