API Reference for Marketo Engage

Update Folder Metadata

POST /rest/asset/v1/folder/{id}.json

Updates the metadata for a given folder.

Operation ID
updateFolderUsingPOST
Permissions
Read-Write Assets
Request format
application/x-www-form-urlencoded
Returns
ResponseOfFolderResponse

Parameters

Path 1

id integer (int32) required

Id of the folder to update

Request body

application/x-www-form-urlencoded · required · UpdateFolderRequest · 4 properties

Sent as URL-encoded form fields. Object properties are sent as JSON text in their field.

description string

Description of the asset

isArchive boolean

Whether the folder is archived or not. Toggling this value will change the archival status of the folder

name string

Name of the Folder

type string required

Type of folder. 'Folder' or 'Program'

Values Folder Program

Responses

200 OK ResponseOfFolderResponse
errors array of Error

Model Error

code string required

Error code of the error. See full list of error codes here

message string required

Message describing the cause of the error

requestId string
result array of FolderResponse

Model FolderResponse

accessZoneId integer (int32)
createdAt string (date-time) required

Datetime the folder was created

description string

Description of the folder

folderId Folder required

Id of the folder

Model Folder

id integer (int32) required

Id of the folder

type string required

Type of folder

Values Folder Program

folderType string required

Type of folder

Show all 14 values

Email Email Batch Program Email Template Image Landing Page Landing Page Form Landing Page Template Marketing Event Marketing Folder Marketing Program Nurture Program Report Revenue Cycle Model Zone

id integer (int32) required

Id of the folder

isArchive boolean required

Archival status of the folder

isSystem boolean

Whether the folder is system-managed

name string required

Name of the folder. Not applicable for Programs

parent Folder required

Parent folder reference

Model Folder

id integer (int32) required

Id of the folder

type string required

Type of folder

Values Folder Program

path string required

Path of the folder

updatedAt string (date-time) required

Datetime the folder was last updated

url string required

Url of the folder

workspace string

Name of the workspace

success boolean
warnings array of string
Generated example
{
  "errors": [
    {
      "code": "string",
      "message": "string"
    }
  ],
  "requestId": "123",
  "result": [
    {
      "accessZoneId": 123,
      "createdAt": "2026-01-15T10:30:00Z",
      "description": "string",
      "folderId": {
        "id": 123,
        "type": "Folder"
      },
      "folderType": "Email",
      "id": 123,
      "isArchive": true,
      "isSystem": true,
      "name": "Example name",
      "parent": {
        "id": 123,
        "type": "Folder"
      },
      "path": "string",
      "updatedAt": "2026-01-15T10:30:00Z",
      "url": "https://example.com",
      "workspace": "string"
    }
  ],
  "success": true,
  "warnings": [
    "string"
  ]
}

Referenced models

Generated from swagger-asset.json. Generated examples are inferred from the schema; they are illustrative and may not be valid production payloads.

↑ ↓ to move, ↵ to open, esc to closeSee all results