When enabling and disabling raw mode, changes will occur in the typing of parameters. All parameters will become String, and when returning to Raw mode, the old typing will no longer be available.

The Raw mode was created to allow sending other typings as parameters in Http Tools, thus allowing total freedom in sending custom payloads. The types currently allowed in Raw mode are:

  • Number: Rational number
  • Integer: Integer number
  • String: Standard text value
  • Object: JSON object with various properties
  • Array: List of parameters of a certain typing

Activating Raw mode disables the validation modal.


Structuring Your Payload in Raw Mode

Standard Structure

[
  {
    "field name": {
      "type": "data type",
      "isUserProvided": false or true,
      "description": "description on how the field should be filled",
      "enum": ["values to be used"],
      "value": "value to be passed when isUserProvided = false",
      "items": {
        "type": "data type to be inserted into the array"
      },
      "properties": {
        "insert a new field here filled in the same way as the parent field"
      }
    }
  }
]

Inserting Multiple Data

[
  {
    "data1": {
      ...
    }
  },
  {
    "data2": {
      ...
    }
  },
  {
    "data3": {
      ...
    }
  },
  ...
]

Data Types

String

"stringRaw": {
  "type": "string",
  "isUserProvided": true,
  "description": "stringRaw"
}

Number

"numberRaw": {
  "type": "number",
  "isUserProvided": false,
  "description": "numberRaw",
  "value": 1.11
}

Integer

"integerRaw": {
  "type": "integer",
  "isUserProvided": true,
  "description": "integerRaw"
}

Array

"arrayRaw": {
  "type": "array",
  "isUserProvided": false,
  "description": "arrayRaw",
  "items": {
    "type": "string"
  }
}

Object

"objectRaw": {
  "type": "object",
  "properties": {
    "stringChildren": {
      "type": "string",
      "isUserProvided": true,
      "description": "stringChildren"
    },
    ...
  }
}

Configuration Steps

  1. Navigate to your Http Tool Configuration:
    Go to Agents > Select Agent > Tools > Http-Tools: Integrate with an HTTP API.

  2. Toggle and Configure Raw Mode:

    • Click the toggle button to enable Raw Mode.
    • Configure Raw mode settings according to our documentation.
  3. Save Your Changes:
    Confirm and save your configuration to apply the Raw mode settings.