Ayla Networks Role Labels API

The Role Labels API from Ayla Networks — 1 operation(s) for role labels.

Operations 3

GET /role_labels/{roleId}.json Get role label #
PUT /role_labels/{roleId}.json Update role label #
DELETE /role_labels/{roleId}.json Delete role label #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/ayla-networks:ayla-networks-role-labels-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

ayla-networks-role-labels-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: device-service Role Labels API
  version: '1.0'
servers:
- url: https://ads-dev.aylanetworks.com/apiv1/
security:
- sec0: []
tags:
- name: Role Labels
paths:
  /role_labels/{roleId}.json:
    get:
      summary: Get role label
      description: This API returns a role label.
      operationId: get-role-label
      parameters:
      - name: roleId
        in: path
        description: Unique role identifier.
        schema:
          type: string
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              examples:
                Result:
                  value:
                    role_label:
                      id: 9239
                      role_name: EndUser
                      description: end user
                      key: null
                      value: null
                      role_label_hierarchies: []
              schema:
                type: object
                properties:
                  role_label:
                    type: object
                    properties:
                      id:
                        type: integer
                        example: 9239
                        default: 0
                      role_name:
                        type: string
                        example: EndUser
                      description:
                        type: string
                        example: end user
                      key:
                        type: string
                      value:
                        type: string
                      role_label_hierarchies:
                        type: array
                        items:
                          type: object
                          properties: {}
        '401':
          content:
            application/json:
              schema:
                type: object
                properties: {}
              examples:
                Unauthorized:
                  summary: Unauthorized
                  value: '{}'
          description: Unauthorized
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                type: object
                properties: {}
      deprecated: false
      tags:
      - Role Labels
    put:
      summary: Update role label
      description: 'This API updates a role label.


        Include only the fields you want to update.'
      operationId: update-role-label
      parameters:
      - name: roleId
        in: path
        description: Unique role identifier.
        schema:
          type: string
        required: true
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                role_label:
                  properties:
                    role_name:
                      type: string
                      description: Name of the role.
                    description:
                      type: string
                      description: Role description.
                  required: []
                  type: object
      responses:
        '200':
          description: OK
          content:
            application/json: {}
        '401':
          content: {}
          description: Unauthorized
        '403':
          content: {}
          description: Forbidden
        '404':
          content: {}
          description: Not Found
        '422':
          content: {}
          description: Unprocessable Entity
      deprecated: false
      tags:
      - Role Labels
    delete:
      summary: Delete role label
      description: This API deletes the specified role label.
      operationId: delete-role-label-by-id
      parameters:
      - name: roleId
        in: path
        description: Unique role identifier.
        schema:
          type: string
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json: {}
        '401':
          content: {}
          description: Unauthorized
        '403':
          content: {}
          description: Forbidden
        '404':
          content: {}
          description: Not Found
      deprecated: false
      tags:
      - Role Labels
components:
  securitySchemes:
    sec0:
      type: apiKey
      in: header
      name: Authorization
      x-bearer-format: ''
      x-default: auth_token
x-readme-fauxas: true
x-provenance:
  method: searched
  source: https://docs.aylanetworks.com/reference
  harvested: '2026-10-14'
  tool: harvest-readme-openapi.py
  note: Assembled verbatim from the OpenAPI definition ReadMe embeds in each operation page of the provider's developer portal; paths and components merged by API title, nothing authored.
  assembled_from:
  - https://docs.aylanetworks.com/reference/add-device-to-group.md
  - https://docs.aylanetworks.com/reference/assign-dealer-to-group.md
  - https://docs.aylanetworks.com/reference/associate-a-role-label.md
  - https://docs.aylanetworks.com/reference/clear-schedule.md
  - https://docs.aylanetworks.com/reference/create-a-datapoint-by-device-id.md
  - https://docs.aylanetworks.com/reference/create-a-notification.md
  - https://docs.aylanetworks.com/reference/create-a-schedule.md
  - https://docs.aylanetworks.com/reference/create-associated-user-1.md
  - https://docs.aylanetworks.com/reference/create-datapoint-by-dsn.md
  - https://docs.aylanetworks.com/reference/create-datapoint-message-by-dsn.md
  - https://docs.aylanetworks.com/reference/create-datapoints-in-group-1.md
  - https://docs.aylanetworks.com/reference/create-datapoints-in-group.md
  - https://docs.aylanetworks.com/reference/create-datapoints.md
  - https://docs.aylanetworks.com/reference/create-device-metadata.md
  - https://docs.aylanetworks.com/reference/create-group.md
  - https://docs.aylanetworks.com/reference/create-notification-app.md
  - https://docs.aylanetworks.com/reference/create-notification-app1.md
  - https://docs.aylanetworks.com/reference/create-schedule-action.md
  - https://docs.aylanetworks.com/reference/create-template-1.md
  - https://docs.aylanetworks.com/reference/create-template-2.md
  - https://docs.aylanetworks.com/reference/create-template-properties.md
  - https://docs.aylanetworks.com/reference/create-template.md
  - https://docs.aylanetworks.com/reference/create-trigger-1.md
  - https://docs.aylanetworks.com/reference/create-trigger.md
  - https://docs.aylanetworks.com/reference/delete-device-address.md
  - https://docs.aylanetworks.com/reference/delete-device-metadata.md
  - https://docs.aylanetworks.com/reference/delete-group.md
  - https://docs.aylanetworks.com/reference/delete-notification-by-id.md
  - https://docs.aylanetworks.com/reference/delete-notification.md
  - https://docs.aylanetworks.com/reference/delete-role-label-by-id.md
  - https://docs.aylanetworks.com/reference/delete-schedule-action-by-id.md
  - https://docs.aylanetworks.com/reference/delete-trigger-apps-by-id.md
  - https://docs.aylanetworks.com/reference/delete-trigger-by-id.md
  - https://docs.aylanetworks.com/reference/disassociate-a-role-label-to-a-device.md
  - https://docs.aylanetworks.com/reference/enable-role-on-device.md
  - https://docs.aylanetworks.com/reference/factory-reset-device-id114.md
  - https://docs.aylanetworks.com/reference/get-a-property-by-name.md
  - https://docs.aylanetworks.com/reference/get-a-schedule-by-name.md
  - https://docs.aylanetworks.com/reference/get-all-notifications.md
  - https://docs.aylanetworks.com/reference/get-all-triggers.md
  - https://docs.aylanetworks.com/reference/get-associated-devices-1.md
  - https://docs.aylanetworks.com/reference/get-associated-devices-by-email.md
  - https://docs.aylanetworks.com/reference/get-associated-devices.md
  - https://docs.aylanetworks.com/reference/get-commands-1.md
  - https://docs.aylanetworks.com/reference/get-commands.md
  - https://docs.aylanetworks.com/reference/get-connection-history.md
  - https://docs.aylanetworks.com/reference/get-datapoint-by-device-id.md
  - https://docs.aylanetworks.com/reference/get-datapoint-by-dsn-id.md
  - https://docs.aylanetworks.com/reference/get-datapoints-by-dsn.md
  - https://docs.aylanetworks.com/reference/get-datapoints-in-group.md
  - https://docs.aylanetworks.com/reference/get-device-address.md
  - https://docs.aylanetworks.com/reference/get-device-by-device-id.md
  - https://docs.aylanetworks.com/reference/get-device-by-dsn-1.md
  - https://docs.aylanetworks.com/reference/get-device-by-dsn.md
  - https://docs.aylanetworks.com/reference/get-device-metadata-by-key.md
  - https://docs.aylanetworks.com/reference/get-device-metadata.md
  - https://docs.aylanetworks.com/reference/get-device-role-label.md
  - https://docs.aylanetworks.com/reference/get-group-by-id.md
  - https://docs.aylanetworks.com/reference/get-groups.md
  - https://docs.aylanetworks.com/reference/get-lan-data.md
  - https://docs.aylanetworks.com/reference/get-nodes-by-device-id-id117.md
  - https://docs.aylanetworks.com/reference/get-nodes-by-dsn-1.md
  - https://docs.aylanetworks.com/reference/get-nodes-by-dsn.md
  - https://docs.aylanetworks.com/reference/get-notification-app.md
  - https://docs.aylanetworks.com/reference/get-notification-by-id-1.md
  - https://docs.aylanetworks.com/reference/get-notification.md
  - https://docs.aylanetworks.com/reference/get-notifications.md
  - https://docs.aylanetworks.com/reference/get-properties-by-device-id.md
  - https://docs.aylanetworks.com/reference/get-properties-by-dsn.md
  - https://docs.aylanetworks.com/reference/get-registrable-device.md
  - https://docs.aylanetworks.com/reference/get-role-label.md
  - https://docs.aylanetworks.com/reference/get-schedule-action-by-id.md
  - https://docs.aylanetworks.com/reference/get-schedule-action-by-name.md
  - https://docs.aylanetworks.com/reference/get-schedule-action.md
  - https://docs.aylanetworks.com/reference/get-schedule-by-id.md
  - https://docs.aylanetworks.com/reference/get-schedules-for-user.md
  - https://docs.aylanetworks.com/reference/get-schedules.md
  - https://docs.aylanetworks.com/reference/get-template.md
  - https://docs.aylanetworks.com/reference/get-timezone-1.md
  - https://docs.aylanetworks.com/reference/get-timezone.md
  - https://docs.aylanetworks.com/reference/get-trigger-app.md
  - https://docs.aylanetworks.com/reference/get-trigger-apps.md
  - https://docs.aylanetworks.com/reference/get-trigger-by-id.md
  - https://docs.aylanetworks.com/reference/get-trigger.md
  - https://docs.aylanetworks.com/reference/gets-datapoint-by-device-id.md
  - https://docs.aylanetworks.com/reference/gets-property-by-device-di.md
  - https://docs.aylanetworks.com/reference/identify-zigbee-node-id115.md
  - https://docs.aylanetworks.com/reference/register-device-to-user.md
  - https://docs.aylanetworks.com/reference/register-device.md
  - https://docs.aylanetworks.com/reference/remove-device-from-group.md
  - https://docs.aylanetworks.com/reference/rename-device-by-device-id.md
  - https://docs.aylanetworks.com/reference/rename-group.md
  - https://docs.aylanetworks.com/reference/search-devices.md
  - https://docs.aylanetworks.com/reference/set-device-timezone.md
  - https://docs.aylanetworks.com/reference/transfer-registration.md
  - https://docs.aylanetworks.com/reference/unregister-a-device.md
  - https://docs.aylanetworks.com/reference/unregister-device.md
  - https://docs.aylanetworks.com/reference/update-device-address.md
  - https://docs.aylanetworks.com/reference/update-device-location-id116.md
  - https://docs.aylanetworks.com/reference/update-device-metadata.md
  - https://docs.aylanetworks.com/reference/update-notification.md
  - https://docs.aylanetworks.com/reference/update-role-label.md
  - https://docs.aylanetworks.com/reference/update-schedule-action.md
  - https://docs.aylanetworks.com/reference/update-schedule1.md
  - https://docs.aylanetworks.com/reference/update-trigger-app.md
  - https://docs.aylanetworks.com/reference/update-trigger1.md
  merge:
    pages: 106
    deduped: 105
    conflicts_kept_first: 0