API Reference

Get MQTT configuration

get
https://api.edgeiq.io/api/v1/platform/v1/bootstrap

Retrieve MQTT broker and platform configuration for a Coda device.

This endpoint is called by devices before connecting to MQTT to discover their broker endpoint and platform URL. The response format matches the device's conf.json structure for key-based merge.

Configuration is looked up in the following priority order:

  1. Exact match: company_id + device_unique_id
  2. Pattern match: company_id + glob patterns (e.g., "edgeiq-coda-staging-*")
  3. Company default: company_id + "default"
  4. Global default: "default" + "global-config"
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string
required
length between 1 and 128

Unique device identifier. This is typically the device's MAC address or a unique ID assigned during manufacturing.

Examples:

  • edgeiq-coda-00a1b2c3d4e5
  • gateway-prod-001
string
required
length between 1 and 64

Company/tenant identifier. Each company has its own MQTT broker and platform configuration.

Examples:

  • acme-corp
  • globex-inc
  • edgeiq-internal
Responses

500

An unexpected error was encountered.

Updated 3 months ago

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 3 months ago