Cloud functions

Overview of API field limits

API Field < 0.8.0 0.8.0 - 2.x ≥ 3.0.0
Variable Key 12 64 64
Variable Data 622 622 8642 / 10243
Function Key 12 64 64
Function Argument 63 622 8642 / 10243
Publish/Subscribe Event Name 64 64 64
Publish/Subscribe Event Data 255 622 8642 / 10243
  • Limits are in bytes of UTF-8 encoded characters.
  • 2On Gen 2 devices (Photon, P1, Electron, E-Series), the limit is 864 characters,
  • 3On the P2, Photon 2, and Gen 3 devices (Argon, Boron, B-Series SoM, Tracker SoM, and E404X) the limit is 1024 characters.
  • The 0.8.0 - 2.x column includes all 2.x LTS versions. Higher limits will not be back-ported to 2.x LTS.

Instead of hardcoding these values, you should use these definitions:

  • particle::protocol::MAX_VARIABLE_KEY_LENGTH
  • particle::protocol::MAX_VARIABLE_VALUE_LENGTH
  • particle::protocol::MAX_FUNCTION_KEY_LENGTH
  • particle::protocol::MAX_FUNCTION_ARG_LENGTH
  • particle::protocol::MAX_EVENT_NAME_LENGTH
  • particle::protocol::MAX_EVENT_DATA_LENGTH

Additionally, some older Boron and B-Series SoM with a SARA-R410M-02B modem (LTE Cat M1) may have a limit of 782 bytes instead of 1024 bytes, see Particle.maxEventDataSize() for more information.