Marketo

opencollection: 1.0.0
info:
  name: Marketo Engage Rest API
  version: '1.0'
items:
- info:
    name: Assets
    type: folder
  items:
  - info:
      name: Marketo Get Channel by Name
      type: http
    http:
      method: GET
      url: https://localhost:8080/rest/asset/v1/channel/byName.json
      params:
      - name: Name
        value: ''
        type: query
        description: Name of channel to retrieve
    docs: 'Retrieves channels based on the provided name. Required Permissions: Read-Only Assets, Read-Write Assets'
  - info:
      name: Marketo Get Channels
      type: http
    http:
      method: GET
      url: https://localhost:8080/rest/asset/v1/channels.json
      params:
      - name: maxReturn
        value: ''
        type: query
        description: Maximum number of channels to return. Max 200, default 20
      - name: offset
        value: ''
        type: query
        description: Integer offset for paging
    docs: 'Retrieves all channels. Required Permissions: Read-Only Assets, Read-Write Assets'
  - info:
      name: Marketo Get Email by Name
      type: http
    http:
      method: GET
      url: https://localhost:8080/rest/asset/v1/email/byName.json
      params:
      - name: name
        value: ''
        type: query
        description: Name of the email
      - name: status
        value: ''
        type: query
        description: Status filter for draft or approved versions
      - name: folder
        value: ''
        type: query
        description: JSON representation of parent folder, with members 'id', and 'type' which may be 'Folder' or 'Program'
    docs: 'Returns an email records based on the given name. Required Permissions: Read-Only Assets, Read-Write Assets'
  - info:
      name: Marketo Get Email By Id
      type: http
    http:
      method: GET
      url: https://localhost:8080/rest/asset/v1/email/:id.json
      params:
      - name: id
        value: ''
        type: path
        description: id
      - name: status
        value: ''
        type: query
        description: Status filter for draft or approved versions
    docs: 'Returns an email records by its id. Required Permissions: Read-Only Assets, Read-Write Assets'
  - info:
      name: Marketo Update Email Metadata
      type: http
    http:
      method: POST
      url: https://localhost:8080/rest/asset/v1/email/:id.json
      params:
      - name: id
        value: ''
        type: path
        description: id
      body:
        type: form-urlencoded
        data: []
    docs: 'Updates the metadata of an email asset. Required Permissions: Read-Write Assets'
  - info:
      name: Marketo Clone Email
      type: http
    http:
      method: POST
      url: https://localhost:8080/rest/asset/v1/email/:id/clone.json
      params:
      - name: id
        value: ''
        type: path
        description: id
      body:
        type: form-urlencoded
        data: []
    docs: 'Clones the target email. Required Permissions: Read-Write Assets'
  - info:
      name: Marketo Get Email Content
      type: http
    http:
      method: GET
      url: https://localhost:8080/rest/asset/v1/email/:id/content.json
      params:
      - name: id
        value: ''
        type: path
        description: id
      - name: status
        value: ''
        type: query
        description: Status filter for draft or approved versions
    docs: 'Returns the content of the designated email. Required Permissions: Read-Only Assets, Read-Write Assets'
  - info:
      name: Marketo Update Email Content
      type: http
    http:
      method: POST
      url: https://localhost:8080/rest/asset/v1/email/:id/content.json
      params:
      - name: id
        value: ''
        type: path
        description: id
      body:
        type: form-urlencoded
        data: []
    docs: 'Updates the content of an email. Required Permissions: Read-Write Assets'
  - info:
      name: Marketo Rearrange Email Modules
      type: http
    http:
      method: POST
      url: https://localhost:8080/rest/asset/v1/email/:id/content/rearrange.json
      params:
      - name: id
        value: ''
        type: path
        description: id
      body:
        type: form-urlencoded
        data: []
    docs: 'Rearranges the modules in an email. Required Permissions: Read-Write Assets'
  - info:
      name: Marketo Add Email Module
      type: http
    http:
      method: POST
      url: https://localhost:8080/rest/asset/v1/email/:id/content/:moduleId/add.json
      params:
      - name: id
        value: ''
        type: path
        description: id
      - name: moduleId
        value: ''
        type: path
        description: moduleId
      - name: name
        value: ''
        type: query
        description: Name of the module
      - name: index
        value: ''
        type: query
        description: Index of the module. Determines the order of the module in the email.
    docs: 'Adds a new module to an email, with the given id. Required Permissions: Read-Write Assets'
  - info:
      name: Marketo Delete Module
      type: http
    http:
      method: POST
      url: https://localhost:8080/rest/asset/v1/email/:id/content/:moduleId/delete.json
      params:
      - name: id
        value: ''
        type: path
        description: id
      - name: moduleId
        value: ''
        type: path
        description: moduleId
    docs: 'Deletes the given module from the email. Required Permissions: Read-Write Assets'
  - info:
      name: Marketo Duplicate Email Module
      type: http
    http:
      method: POST
      url: https://localhost:8080/rest/asset/v1/email/:id/content/:moduleId/duplicate.json
      params:
      - name: id
        value: ''
        type: path
        description: id
      - name: moduleId
        value: ''
        type: path
        description: moduleId
      - name: name
        value: ''
        type: query
        description: Name of the new module
    docs: 'Creates a copy of the designated module in an email. Required Permissions: Read-Write Assets'
  - info:
      name: Marketo Rename Email Module
      type: http
    http:
      method: POST
      url: https://localhost:8080/rest/asset/v1/email/:id/content/:moduleId/rename.json
      params:
      - name: id
        value: ''
        type: path
        description: id
      - name: moduleId
        value: ''
        type: path
        description: moduleId
      - name: name
        value: ''
        type: query
        description: New module name
    docs: 'Renames a module. Required Permissions: Read-Write Assets'
  - info:
      name: Marketo Delete Email
      type: http
    http:
      method: POST
      url: https://localhost:8080/rest/asset/v1/email/:id/delete.json
      params:
      - name: id
        value: ''
        type: path
        description: id
    docs: 'Deletes the target email. Required Permissions: Read-Write Assets'
  - info:
      name: Marketo Discard Email Draft
      type: http
    http:
      method: POST
      url: https://localhost:8080/rest/asset/v1/email/:id/discardDraft.json
      params:
      - name: id
        value: ''
        type: path
        description: id
    docs: 'Discards the current draft of an email. Required Permissions: Read-Write Assets'
  - info:
      name: Marketo Get Email Dynamic Content
      type: http
    http:
      method: GET
      url: https://localhost:8080/rest/asset/v1/email/:id/dynamicContent/:contentId.json
      params:
      - name: id
        value: ''
        type: path
        description: Id of email
      - name: contentId
        value: ''
        type: path
        description: Id of email dynamic content section
      - name: status
        value: ''
        type: query
        description: Status filter for draft or approved versions
    docs: 'Retrieves the dyanmic content record for the given section. Required Permissions: Read-Only Assets, Read-Write
      Assets'
  - info:
      name: Marketo Update Email Dynamic Content Section
      type: http
    http:
      method: POST
      url: https://localhost:8080/rest/asset/v1/email/:id/dynamicContent/:contentId.json
      params:
      - name: id
        value: ''
        type: path
        description: Id of email
      - name: contentId
        value: ''
        type: path
        description: Id of email dynamic content section
      body:
        type: form-urlencoded
        data: []
    docs: 'Updates dynamic content in the given section. Required Permissions: Read-Write Assets'
  - info:
      name: Marketo Send Sample Email
      type: http
    http:
      method: POST
      url: https://localhost:8080/rest/asset/v1/email/:id/sendSample.json
      params:
      - name: id
        value: ''
        type: path
        description: Id of the email
      body:
        type: form-urlencoded
        data: []
    docs: 'Sends a sample email to the given email address. Leads may be impersonated to populate data for tokens and dynamic
      content. Required Permissions: Read-Write Assets'
  - info:
      name: Marketo Unapprove Email
      type: http
    http:
      method: POST
      url: https://localhost:8080/rest/asset/v1/email/:id/unapprove.json
      params:
      - name: id
        value: ''
        type: path
        description: id
    docs: 'Unapproves the email and reverts it to a draft-only state. Required Permissions: Approve Assets'
  - info:
      name: Marketo Update Email Variable
      type: http
    http:
      method: POST
      url: https://localhost:8080/rest/asset/v1/email/:id/variable/:name.json
      params:
      - name: id
        value: ''
        type: path
        description: id
      - name: name
        value: ''
        type: path
        description: name
      body:
        type: form-urlencoded
        data: []
    docs: 'Updates the value of a given variable in an email. Required Permissions: Read-Write Assets'
  - info:
      name: Marketo Get Email Variables
      type: http
    http:
      method: GET
      url: https://localhost:8080/rest/asset/v1/email/:id/variables.json
      params:
      - name: id
        value: ''
        type: path
        description: id
    docs: 'Returns a list of the available variables in an email. Required Permissions: Read-Only Assets, Read-Write Assets'
  - info:
      name: Marketo Get Email CC Fields
      type: http
    http:
      method: GET
      url: https://localhost:8080/rest/asset/v1/email/ccFields.json
    docs: 'Returns the set of fields enabled for Email CC in the target instance. Required Permissions: Read-Only Assets,
      Read-Write Assets'
  - info:
      name: Marketo Get Email Template by Name
      type: http
    http:
      method: GET
      url: https://localhost:8080/rest/asset/v1/emailTemplate/byName.json
      params:
      - name: name
        value: ''
        type: query
        description: name
      - name: status
        value: ''
        type: query
        description: Status filter for draft or approved versions
    docs: 'Retrieves and email template record by the given name. Required Permissions: Read-Only Assets, Read-Write Assets'
  - info:
      name: Marketo Get Email Template by Id
      type: http
    http:
      method: GET
      url: https://localhost:8080/rest/asset/v1/emailTemplate/:id.json
      params:
      - name: id
        value: ''
        type: path
        description: id
      - name: status
        value: ''
        type: query
        description: Status filter for draft or approved versions
    docs: 'Returns an email template record by its id. Required Permissions: Read-Only Assets, Read-Write Assets'
  - info:
      name: Marketo Update Email Template Metadata
      type: http
    http:
      method: POST
      url: https://localhost:8080/rest/asset/v1/emailTemplate/:id.json
      params:
      - name: id
        value: ''
        type: path
        description: id
      body:
        type: form-urlencoded
        data: []
    docs: 'Updates the metadata for the designated email template. Required Permissions: Read-Write Assets'
  - info:
      name: Marketo Clone Email Template
      type: http
    http:
      method: POST
      url: https://localhost:8080/rest/asset/v1/emailTemplate/:id/clone.json
      params:
      - name: id
        value: ''
        type: path
        description: id
      body:
        type: form-urlencoded
        data: []
    docs: 'Clones the designated email template. Required Permissions: Read-Write Assets'
  - info:
      name: Marketo Get Email Template Content by Id
      type: http
    http:
      method: GET
      url: https://localhost:8080/rest/asset/v1/emailTemplate/:id/content
      params:
      - name: id
        value: ''
        type: path
        description: id
      - name: status
        value: ''
        type: query
        description: Status filter for draft or approved versions
    docs: 'Returns the content for a given email template. Required Permissions: Read-Only Assets, Read-Write Assets'
  - info:
      name: Marketo Update Email Template Content
      type: http
    http:
      method: POST
      url: https://localhost:8080/rest/asset/v1/emailTemplate/:id/content.json
      params:
      - name: id
        value: ''
        type: path
        description: id
      body:
        type: multipart-form
        data: []
    docs: 'Updates the content of the given email template. Required Permissions: Read-Write Assets'
  - info:
      name: Marketo Delete Email Template
      type: http
    http:
      method: POST
      url: https://localhost:8080/rest/asset/v1/emailTemplate/:id/delete.json
      params:
      - name: id
        value: ''
        type: path
        description: id
    docs: 'Deletes the designated email template. Required Permissions: Read-Write Assets'
  - info:
      name: Marketo Discard Email Template Draft
      type: http
    http:
      method: POST
      url: https://localhost:8080/rest/asset/v1/emailTemplate/:id/discardDraft.json
      params:
      - name: id
        value: ''
        type: path
        description: id
    docs: 'Discards the current draft of the email template. Required Permissions: Read-Write Assets'
  - info:
      name: Marketo Unapprove Email Template Draft
      type: http
    http:
      method: POST
      url: https://localhost:8080/rest/asset/v1/emailTemplate/:id/unapprove.json
      params:
      - name: id
        value: ''
        type: path
        description: id
    docs: 'Unapproves the current approved version of the Email Template. Required Permissions: Approve Assets'
  - info:
      name: Marketo Get Email Templates
      type: http
    http:
      method: GET
      url: https://localhost:8080/rest/asset/v1/emailTemplates.json
      params:
      - name: offset
        value: ''
        type: query
        description: Integer offset for paging
      - name: maxReturn
        value: ''
        type: query
        description: Maximum number of channels to return. Max 200, default 20
      - name: status
        value: ''
        type: query
        description: Status filter for draft or approved versions
    docs: 'Returns a list of email template records accessible in the target instance. Required Permissions: Read-Only Assets,
      Read-Write Assets'
  - info:
      name: Marketo Create Email Template
      type: http
    http:
      method: POST
      url: https://localhost:8080/rest/asset/v1/emailTemplates.json
      body:
        type: multipart-form
        data: []
    docs: 'Creates a new email template. Required Permissions: Read-Write Assets'
  - info:
      name: Marketo Get Email Template Used By
      type: http
    http:
      method: GET
      url: https://localhost:8080/rest/asset/v1/emailTemplates/:id/usedBy.json
      params:
      - name: id
        value: ''
        type: path
        description: Id of the email template
      - name: offset
        value: ''
        type: query
        description: Integer offset for paging
      - name: maxReturn
        value: ''
        type: query
        description: Maximum number of channels to return. Max 200, default 20
    docs: 'Returns a list of email records which depend on a given email template. Required Permissions: Read-Only Assets,
      Read-Write Assets'
  - info:
      name: Marketo Get Emails
      type: http
    http:
      method: GET
      url: https://localhost:8080/rest/asset/v1/emails.json
      params:
      - name: status
        value: ''
        type: query
        description: Status filter for draft or approved versions
      - name: folder
        value: ''
        type: query
        description: JSON representation of parent folder, with members 'id', and 'type' which may be 'Folder' or 'Program'
      - name: offset
        value: ''
        type: query
        description: Integer offset for paging
      - name: maxReturn
        value: ''
        type: query
        description: Maximum number of emails to return. Max 200, default 20
      - name: earliestUpdatedAt
        value: ''
        type: query
        description: Exclude emails prior to this date. Must be valid ISO-8601 string. See <a href="http://developers.marketo.com/rest-api/lead-database/fields/field-types/">Datetime</a>
          field type description.
      - name: latestUpdatedAt
        value: ''
        type: query
        description: Exclude emails after this date. Must be valid ISO-8601 string. See <a href="http://developers.marketo.com/rest-api/lead-database/fields/field-types/">Datetime</a>
          field type description.
    docs: 'Returns a list of emails matching the given filter parameters. Required Permissions: Read-Only Assets, Read-Write
      Assets'
  - info:
      name: Marketo Create Email
      type: http
    http:
      method: POST
      url: https://localhost:8080/rest/asset/v1/emails.json
      body:
        type: form-urlencoded
        data: []
    docs: 'Creates a new email asset. Required Permissions: Read-Write Assets'
  - info:
      name: Marketo Get Email Full Content
      type: http
    http:
      method: GET
      url: https://localhost:8080/rest/asset/v1/email/:id/fullContent.json
      params:
      - name: id
        value: ''
        type: path
        description: Id of the email
      - name: status
        value: ''
        type: query
        description: Status filter for draft or approved versions. Defaults to approved if asset is approved, draft if not.
      - name: leadId
        value: ''
        type: query
        description: The lead id to impersonate. Email is rendered as though it was received by this lead.
      - name: type
        value: ''
        type: query
        description: Email content type to return. Default is HTML.
    docs: 'Returns the serialized HTML version of the email. Required Permissions: Read-Only Assets, Read-Write Assets. If
      leadId is passed in the request: Read-Only Lead, Read-Write Lead.'
  - info:
      name: Marketo Update Email Full Content
      type: http
    http:
      method: POST
      url: https://localhost:8080/rest/asset/v1/email/:id/fullContent.json
      params:
      - name: id
        value: ''
        type: path
        description: Id of the email
      body:
        type: multipart-form
        data: []
    docs: 'Replaces the HTML of an Email that has had its relationship broken from its template. Required Permissions: Read-Write
      Assets'
  - info:
      name: Marketo Get File by Name
      type: http
    http:
      method: GET
      url: https://localhost:8080/rest/asset/v1/file/byName.json
      params:
      - name: name
        value: ''
        type: query
        description: Name of the file
    docs: 'Returns files records for the given name. Required Permissions: Read-Only Assets, Read-Write Assets'
  - info:
      name: Marketo Get File by Id
      type: http
    http:
      method: GET
      url: https://localhost:8080/rest/asset/v1/file/:id.json
      params:
      - name: id
        value: ''
        type: path
        description: Id for file in database
    docs: 'Returns the file record for the given id. Required Permissions: Read-Only Assets, Read-Write Assets'
  - info:
      name: Marketo Update File Content
      type: http
    http:
      method: POST
      url: https://localhost:8080/rest/asset/v1/file/:id/content.json
      params:
      - name: id
        value: ''
        type: path
        description: Id for file in database
      body:
        type: multipart-form
        data: []
    docs: 'Replaces the current content of the file with the included payload. Required Permissions: Read-Write Assets'
  - info:
      name: Marketo Get Files
      type: http
    http:
      method: GET
      url: https://localhost:8080/rest/asset/v1/files.json
      params:
      - name: folder
        value: ''
        type: query
        description: JSON representation of parent folder, with members 'id', and 'type' which may be 'Folder' or 'Program'
      - name: offset
        value: ''
        type: query
        description: Integer offset for paging. Default 0
      - name: maxReturn
        value: ''
        type: query
        description: Maximum number of files to return. Max 200, default 20
    docs: 'Returns the files from the given folder. Required Permissions: Read-Only Assets, Read-Write Assets'
  - info:
      name: Marketo Create File
      type: http
    http:
      method: POST
      url: https://localhost:8080/rest/asset/v1/files.json
      body:
        type: multipart-form
        data: []
    docs: 'Creates a new file from the included payload. Required Permissions: Read-Write Assets'
  - info:
      name: Marketo Get Folder by Name
      type: http
    http:
      method: GET
      url: https://localhost:8080/rest/asset/v1/folder/byName.json
      params:
      - name: name
        value: ''
        type: query
        description: Name of the folder. Not applicable for Programs
      - name: type
        value: ''
        type: query
        description: Type of folder. 'Folder' or 'Program'
      - name: root
        value: ''
        type: query
        description: Parent folder reference
      - name: workSpace
        value: ''
        type: query
        description: Name of the workspace
    docs: 'Returns a folder record for the given name. Required Permissions: Read-Only Assets, Read-Write Assets'
  - info:
      name: Marketo Get Folder by Id
      type: http
    http:
      method: GET
      url: https://localhost:8080/rest/asset/v1/folder/:id.json
      params:
      - name: id
        value: ''
        type: path
        description: Id of the folder to retrieve
      - name: type
        value: ''
        type: query
        description: Type of folder. 'Folder' or 'Program'
    docs: 'Returns the folder record with the given id. Required Permissions: Read-Only Assets, Read-Write Assets'
  - info:
      name: Marketo Update Folder Metadata
      type: http
    http:
      method: POST
      url: https://localhost:8080/rest/asset/v1/folder/:id.json
      params:
      - name: id
        value: ''
        type: path
        description: Id of the folder to update
      body:
        type: form-urlencoded
        data: []
    docs: 'Updates the metadata for a given folder. Required Permissions: Read-Write Assets'
  - info:
      name: Marketo Get Folder Contents
      type: http
    http:
      method: GET
      url: https://localhost:8080/rest/asset/v1/folder/:id/content.json
      params:
      - name: id
        value: ''
        type: path
        description: Id of the folder to retrieve
      - name: maxReturn
        value: ''
        type: query
        description: Maximum number of channels to return. Max 200, default 20
      - name: offset
        value: ''
        type: query
        description: Integer offset for paging
      - name: type
        value: ''
        type: query
        description: Type of folder. 'Folder' or 'Program'. Default is 'Folder'
    docs: 'Returns records for the contents of a given folder. Required Permissions: Read-Only Assets, Read-Write Assets'
  - info:
      name: Marketo Delete Folder
      type: http
    http:
      method: POST
      url: https://localhost:8080/rest/asset/v1/folder/:id/delete.json
      params:
      - name: id
        value: ''
        type: path
        description: Id of the folder to delete
      body:
        type: form-urlencoded
        data:
        - name: type
          value: ''
    docs: 'Deletes the designated folder. Deletion will fail if the folder has content. Required Permissions: Read-Write Assets'
  - info:
      name: Marketo Get Tokens by Folder Id
      type: http
    http:
      method: GET
      url: https://localhost:8080/rest/asset/v1/folder/:id/tokens.json
      params:
      - name: id
        value: ''
        type: path
        description: id
      - name: folderType
        value: ''
        type: query
        description: Type of folder. 'Folder' or 'Program'
    docs: 'Retrieves the list of available My Tokens in the target folder. Required Permissions: Read-Only Assets, Read-Write
      Assets'
  - info:
      name: Marketo Create Token
      type: http
    http:
      method: POST
      url: https://localhost:8080/rest/asset/v1/folder/:id/tokens.json
      params:
      - name: id
        value: ''
        type: path
        description: Id of the folder to which the token will be associated with
      body:
        type: form-urlencoded
        data: []
    docs: 'Create or update a token in the parent folder. Required Permissions: Read-Write Assets'
  - info:
      name: Marketo Delete Token by Name
      type: http
    http:
      method: POST
      url: https://localhost:8080/rest/asset/v1/folder/:id/tokens/delete.json
      params:
      - name: id
        value: ''
        type: path
        description: id
      body:
        type: form-urlencoded
        data: []
    docs: 'Deletes a token with the given name from the parent folder. Required Permissions: Read-Write Assets'
  - info:
      name: Marketo Get Folders
      type: http
    http:
      method: GET
      url: https://localhost:8080/rest/asset/v1/folders.json
      params:
      - name: root
        value: ''
        type: query
        description: Parent folder reference
      - name: maxDepth
        value: ''
        type: query
        description: Maximum folder depth to traverse, Default 2
      - name: maxReturn
        value: ''
        type: query
        description: Maximum number of folders to return. Default 20, maximum 200
      - name: offset
        value: ''
        type: query
        description: Integer offset for paging. Default 0
      - name: workSpace
        value: ''
        type: query
        description: Name of the workspace
    docs: 'Retrieves child folders from within a given root folder. Required Permissions: Read-Only Assets, Read-Write Assets'
  - info:
      name: Marketo Create Folder
      type: http
    http:
      method: POST
      url: https://localhost:8080/rest/asset/v1/folders.json
      body:
        type: form-urlencoded
        data: []
    docs: 'Creates a new folder. Required Permissions: Read-Write Assets'
  - info:
      name: Marketo Get Form by Name
      type: http
    http:
      method: GET
      url: https://localhost:8080/rest/asset/v1/form/byName.json
      params:
      - name: name
        value: ''
        type: query
        description: Name of the form
      - name: status
        value: ''
        type: query
        description: Status filter for draft or approved versions
      - name: folder
        value: ''
        type: query
        description: JSON representation of parent folder, with members 'id', and 'type' which may be 'Folder' or 'Program'
    docs: 'Retrieves a form record by its name. Required Permissions: Read-Only Assets, Read-Write Assets'
  - info:
      name: Marketo Get Available Form Fields
      type: http
    http:
      method: GET
      url: https://localhost:8080/rest/asset/v1/form/fields.json
      params:
      - name: maxReturn
        value: ''
        type: query
        description: Maximum number of fields to return. Max 200, default 20
      - name: offset
        value: ''
        type: query
        description: Integer offset for paging
    docs: 'Retrieves a list of all valid fields for use in forms. Required Permissions: Read-Only Assets, Read-Write Assets'
  - info:
      name: Marketo Get Available Form Program Member Fields
      type: http
    http:
      method: GET
      url: https://localhost:8080/rest/asset/v1/form/programMemberFields.json
      params:
      - name: maxReturn
        value: ''
        type: query
        description: Maximum number of fields to return. Max 200, default 20
      - name: offset
        value: ''
        type: query
        description: Integer offset for paging
    docs: 'Retrieves a list of all valid Program Member fields for use in forms. Required Permissions: Read-Only Assets, Read-Write
      Assets'
  - info:
      name: Marketo Add Form Field Visibility Rules
      type: http
    http:
      method: POST
      url: https://localhost:8080/rest/asset/v1/form/:formId/field/:fieldId/visibility.json
      params:
      - name: formId
        value: ''
        type: path
        description: formId
      - name: fieldId
        value: ''
        type: path
        description: fieldId
      body:
        type: form-urlencoded
        data: []
    docs: 'Adds a visibility rule to the target form field. Required Permissions: Read-Write Assets'
  - info:
      name: Marketo Get Form By Id
      type: http
    http:
      method: GET
      url: https://localhost:8080/rest/asset/v1/form/:id.json
      params:
      - name: id
        value: ''
        type: path
        description: id
      - name: status
        value: ''
        type: query
        description: Status filter for draft or approved versions
    docs: 'Retrieves a form record by its id. Required Permissions: Read-Only Assets, Read-Write Assets'
  - info:
      name: Marketo Update Form Metadata
      type: http
    http:
      method: POST
      url: https://localhost:8080/rest/asset/v1/form/:id.json
      params:
      - name: id
        value: ''
        type: path
        description: id
      body:
        type: form-urlencoded
        data: []
    docs: 'Updates the metadata of the target form. Required Permissions: Read-Write Assets'
  - info:
      name: Marketo Clone Form
      type: http
    http:
      method: POST
      url: https://localhost:8080/rest/asset/v1/form/:id/clone.json
      params:
      - name: id
        value: ''
        type: path
        description: id
      body:
        type: form-urlencoded
        data: []
    docs: 'Clones the target form. Required Permissions: Read-Write Assets'
  - info:
      name: Marketo Delete Form
      type: http
    http:
      method: POST
      url: https://localhost:8080/rest/asset/v1/form/:id/delete.json
      params:
      - name: id
        value: ''
        type: path
        description: id
    docs: 'Deletes the target form. Forms which are in use by landing pages may not be deleted until they are removed from
      all landing pages. Required Permissions: Read-Write Assets'
  - info:
      name: Marketo Discard Form Draft
      type: http
    http:
      method: POST
      url: https://localhost:8080/rest/asset/v1/form/:id/discardDraft.json
      params:
      - name: id
        value: ''
        type: path
        description: id
    docs: 'Discards the current draft of the form. Required Permissions: Read-Write Assets'
  - info:
      name: Marketo Update Form Field
      type: http
    http:
      method: POST
      url: https://localhost:8080/rest/asset/v1/form/:id/field/:fieldId.json
      params:
      - name: id
        value: ''
        type: path
        description: id
      - name: fieldId
        value: ''
        type: path
        description: fieldId
      body:
        type: form-urlencoded
        data: []
    docs: 'Updates the configuration for that target field. Required Permissions: Read-Write Assets'
  - info:
      name: Marketo Delete Form Field
      type: http
    http:
      method: POST
      url: https://localhost:8080/rest/asset/v1/form/:id/field/:fieldId/delete.json
      params:
      - name: id
        value: ''
        type: path
        description: id
      - name: fieldId
        value: ''
        type: path
        description: fieldId
    docs: 'Deletes a field from a form. Required Permissions: Read-Write Assets'
  - info:
      name: Marketo Add Fieldset to Form
      type: http
    http:
      method: POST
      url: https://localhost:8080/rest/asset/v1/form/:id/fieldSet.json
      params:
 

# --- truncated at 32 KB (83 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/marketo/refs/heads/main/apis.yml