# Folders

Use the following endpoint to manage folders in customer accounts.

# Quick reference

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

# List folders

Lists all folders in a customer account.

GET /api/managed_user_id/folders

# URL Parameters

Name Type Description
managed_user_id string
required
Workato Embedded customer Account ID/External ID.
External id should be prefixed with a 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 'x-user-email: <email>' \
      -H 'x-user-token: <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"
        }
    ]
}

# 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 should be prefixed with a 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 'x-user-email: <email>' \
      -H 'x-user-token: <token>' \
      -H 'Content-Type: application/json' \
      -d  '{
            "name": "Salesforce folder"
          }'

# Response

{
  "id": 3498583,
}