Ingest devices through a connector
Adds devices to a KODE API connector, or updates devices you added before. The work runs as a background job.
202 response means the job started, not that the devices exist yet. Read the job with Get a job until status is COMPLETED, then read the devices back. A job has no result for each item.deviceLocation, a text description of where the device is.
- Only KODE API connectors accept ingestion. A connector of another type returns
400. - Send a
deviceExternalIdthat exists already and the API updates the name and the location of that device. It does not create a second device. - The devices are created in the building and the connector in the path. A
buildingIdin the body is ignored. - Ingest devices before you ingest their points. See Ingest points through a connector.
Authorizations
Paste an access token from Create an access token. Tokens expire, so request a new one if you receive 401.
Path Parameters
Building identifier from List buildings.
ID of a KODE API connector, from _id in Create a KODE API connector.
Body
1 - 1000 elementsResponse
The job that was started, with status PROCESSING.
Date and time in UTC, with a numeric offset and no colon, for example 2026-10-28T13:51:31+0000.
"2026-10-28T13:51:31+0000"
Date and time in UTC, with a numeric offset and no colon, for example 2026-10-28T13:51:31+0000.
"2026-10-28T13:51:31+0000"
PENDING, PROCESSING, PROCESSED, COMPLETED, FAILED, CANCELED 
