Marketo Engage Rest API — Fields

naftiko: 1.0.0-alpha2
info:
  label: Marketo Engage Rest API — Fields
  description: 'Marketo Engage Rest API — Fields. 4 operations. Lead operation: Marketo Add Form Field Visibility Rules. Self-contained
    Naftiko capability covering one Marketo business surface.'
  tags:
  - Marketo
  - Fields
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    MARKETO_API_KEY: MARKETO_API_KEY
capability:
  consumes:
  - type: http
    namespace: engage-rest-fields
    baseUri: https://localhost:8080
    description: Marketo Engage Rest API — Fields business capability. Self-contained, no shared references.
    resources:
    - name: rest-asset-v1-form-formId-field-fieldId-visibility.json
      path: /rest/asset/v1/form/{formId}/field/{fieldId}/visibility.json
      operations:
      - name: addformfieldvisibilityruleusingpost
        method: POST
        description: Marketo Add Form Field Visibility Rules
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: formId
          in: path
          type: integer
          description: formId
          required: true
        - name: fieldId
          in: path
          type: string
          description: fieldId
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: rest-asset-v1-form-id-field-fieldId}.json
      path: /rest/asset/v1/form/{id}/field/{fieldId}.json
      operations:
      - name: updateformfieldusingpost
        method: POST
        description: Marketo Update Form Field
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: integer
          description: id
          required: true
        - name: fieldId
          in: path
          type: string
          description: fieldId
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: rest-asset-v1-form-id-field-fieldId-delete.json
      path: /rest/asset/v1/form/{id}/field/{fieldId}/delete.json
      operations:
      - name: deleteformfieldusingpost
        method: POST
        description: Marketo Delete Form Field
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: integer
          description: id
          required: true
        - name: fieldId
          in: path
          type: string
          description: fieldId
          required: true
    - name: rest-asset-v1-form-id-fieldSet-fieldSetId-field-fieldId-delete.json
      path: /rest/asset/v1/form/{id}/fieldSet/{fieldSetId}/field/{fieldId}/delete.json
      operations:
      - name: deleteformfieldfromfieldsetusingpost
        method: POST
        description: Marketo Delete Field from Fieldset
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: integer
          description: id
          required: true
        - name: fieldSetId
          in: path
          type: string
          description: fieldSetId
          required: true
        - name: fieldId
          in: path
          type: string
          description: fieldId
          required: true
  exposes:
  - type: rest
    namespace: engage-rest-fields-rest
    port: 8080
    description: REST adapter for Marketo Engage Rest API — Fields. One Spectral-compliant resource per consumed operation,
      prefixed with /v1.
    resources:
    - path: /v1/asset/v1/form/{formid}/field/{fieldid}/visibility-json
      name: rest-asset-v1-form-formid-field-fieldid-visibility-json
      description: REST surface for rest-asset-v1-form-formId-field-fieldId-visibility.json.
      operations:
      - method: POST
        name: addformfieldvisibilityruleusingpost
        description: Marketo Add Form Field Visibility Rules
        call: engage-rest-fields.addformfieldvisibilityruleusingpost
        with:
          formId: rest.formId
          fieldId: rest.fieldId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/asset/v1/form/{id}/field/fieldid-json
      name: rest-asset-v1-form-id-field-fieldid-json
      description: REST surface for rest-asset-v1-form-id-field-fieldId}.json.
      operations:
      - method: POST
        name: updateformfieldusingpost
        description: Marketo Update Form Field
        call: engage-rest-fields.updateformfieldusingpost
        with:
          id: rest.id
          fieldId: rest.fieldId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/asset/v1/form/{id}/field/{fieldid}/delete-json
      name: rest-asset-v1-form-id-field-fieldid-delete-json
      description: REST surface for rest-asset-v1-form-id-field-fieldId-delete.json.
      operations:
      - method: POST
        name: deleteformfieldusingpost
        description: Marketo Delete Form Field
        call: engage-rest-fields.deleteformfieldusingpost
        with:
          id: rest.id
          fieldId: rest.fieldId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/asset/v1/form/{id}/fieldset/{fieldsetid}/field/{fieldid}/delete-json
      name: rest-asset-v1-form-id-fieldset-fieldsetid-field-fieldid-delete-json
      description: REST surface for rest-asset-v1-form-id-fieldSet-fieldSetId-field-fieldId-delete.json.
      operations:
      - method: POST
        name: deleteformfieldfromfieldsetusingpost
        description: Marketo Delete Field from Fieldset
        call: engage-rest-fields.deleteformfieldfromfieldsetusingpost
        with:
          id: rest.id
          fieldSetId: rest.fieldSetId
          fieldId: rest.fieldId
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: engage-rest-fields-mcp
    port: 9090
    transport: http
    description: MCP adapter for Marketo Engage Rest API — Fields. One tool per consumed operation, routed inline through
      this capability's consumes block.
    tools:
    - name: marketo-add-form-field-visibility
      description: Marketo Add Form Field Visibility Rules
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: engage-rest-fields.addformfieldvisibilityruleusingpost
      with:
        formId: tools.formId
        fieldId: tools.fieldId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: marketo-update-form-field
      description: Marketo Update Form Field
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: engage-rest-fields.updateformfieldusingpost
      with:
        id: tools.id
        fieldId: tools.fieldId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: marketo-delete-form-field
      description: Marketo Delete Form Field
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: engage-rest-fields.deleteformfieldusingpost
      with:
        id: tools.id
        fieldId: tools.fieldId
      outputParameters:
      - type: object
        mapping: $.
    - name: marketo-delete-field-fieldset
      description: Marketo Delete Field from Fieldset
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: engage-rest-fields.deleteformfieldfromfieldsetusingpost
      with:
        id: tools.id
        fieldSetId: tools.fieldSetId
        fieldId: tools.fieldId
      outputParameters:
      - type: object
        mapping: $.