API ReferenceData APIHelp CenterCommunityDevice TutorialsSample Projects
API Reference
LoginSign up

FAQ

Frequently Asked Questions

Why does my request return all objects (devices, variables,...) even though I put a filter in the query parameters?

📘

Invalid Query Parameter Syntax

In case your query parameter syntax is invalid, the query parameter will be ignored. Hence it can lead to all objects being return.

Why doesn't my bulk API call work?

👍

X-Bulk-Operation Header

Most likely you forgot to add the X-Auth-Operation=True header.

Where can I get more information about the endpoints?

📘

HTTP Method OPTIONS

It's always possible to run an OPTIONS request to an endpoint. This returns a detailed JSON object with all attributes and additional information, such as if the attribute is required or read_only.

//Returns additional information about this endpoint
OPTIONS https://industrial.api.ubidots.com/api/v2.0/devices/


{
    "name": "Device List",
    "description": "",
    "renders": [
        "application/json"
    ],
    "parses": [
        "application/json",
        "application/x-www-form-urlencoded",
        "multipart/form-data"
    ],
    "actions": {
        "POST": {
            "url": {
                "type": "field",
                "required": false,
                "read_only": true,
                "label": "Url"
            },
            "id": {
                "type": "string",
                "required": false,
                "read_only": true,
                "label": "Id"
            },
            "organization": {
                "type": "nested object",
                "required": false,
                "read_only": false,
                "label": "Organization",
                "children": {
                    "url": {
                        "type": "field",
                        "required": false,
                        "read_only": true,
                        "label": "Url"
                    },
                    "id": {
                        "type": "string",
                        "required": true,
                        "read_only": false,
                        "label": "Id"
                    },
                    ...
                }
            },
            "label": {
                "type": "string",
                "required": false,
                "read_only": false,
                "label": "Label",
                "max_length": 200
            },
            "properties": {
                "type": "nested object",
                "required": false,
                "read_only": false,
                "label": "Properties",
                "children": {
                    "_icon": {
                        "type": "string",
                        "required": false,
                        "read_only": false,
                        "label": " icon"
                    },
                    "_color": {
                        "type": "string",
                        "required": false,
                        "read_only": false,
                        "label": " color"
                    },
                    ...
                }
            },
            "isActive": {
                "type": "boolean",
                "required": false,
                "read_only": false,
                "label": "Isactive"
            },
            ...
        }
    }
}