Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Zededa AssetGroupService API

The AssetGroupService API from Zededa — 3 operation(s) for assetgroupservice.

Zededa AssetGroupService API is one of 35 APIs that Zededa publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include AssetGroupService. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 6 operations across 3 paths, and defines 15 schemas. It is described by OpenAPI 2.0, at version 1.0.

Requests are made against the base URL https://zedcontrol.zededa.net/api.

6 operations 3 paths 15 schemas 1 DELETE3 GET1 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 2.0
API Version
1.0
Base URL
https://zedcontrol.zededa.net/api
Authentication
API Key
License
Terms of Service
Resource Areas
1

Authentication & Security 1

Zededa AssetGroupService API declares 1 security scheme for authenticating requests. An API key is passed in the header as Authorization (BearerToken). By default, every request must be authenticated.

  • BearerToken — Bearer token for user session

Paths & Operations 6

Across 3 paths, the API surfaces 6 operations — 1 DELETE, 3 GET, 1 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

AssetGroupService 6
GET
/v1/assetgroups
Query asset groups
AssetGroupService_QueryAssetGroups 9 params → 200400401403500504default
POST
/v1/assetgroups
Create asset group
AssetGroupService_CreateAssetGroup 2 params → 200400401403409500504default
GET
/v1/assetgroups/id/{id}
Get asset group
AssetGroupService_GetAssetGroup 2 params → 200401403404500504default
DELETE
/v1/assetgroups/id/{id}
Delete asset group
AssetGroupService_DeleteAssetGroup 2 params → 200401403404409500504default
PUT
/v1/assetgroups/id/{id}
Update asset group
AssetGroupService_UpdateAssetGroup 3 params → 200401403404409500504default
GET
/v1/assetgroups/name/{name}
Get asset group by name
AssetGroupService_GetAssetGroupByName 2 params → 200401403404500504default

Schemas 15

The contract defines 15 schemas that model the data the API accepts and returns. The most detailed are ZsrvResponse (15 properties), AssetGroupRead (8 properties), AssetGroup (7 properties), Cursor (5 properties). Each schema is shown below with its type and property counts.

protobufAny
object
2 properties
ZcOpsType
string
Cursor
object
Cursor helps in filtering the various list response like edge-app bundle list, model list, bundle list etc.
5 properties
ZsrvResponse
object
15 properties
ObjectType
string
AssetTags
object
1 property
AssetGroupRead
object
8 properties
ZsrvErrorCode
string
- zMsgErrorNone: common validation errors - IncompleteData: message had fields that weren't filled in - InvalidData: message contained the field that wasn't ex…
AssetGroupList
object
3 properties
ZsrvError
object
3 properties
googlerpcStatus
object
3 properties
AssetGroup
object
Assetgroups is a proto that should be used by user-agents to create/update asset groups to group various assets like devices
7 properties 1 required
AssetIDs
object
1 property
AssetTag
object
1 property
ZcOpsStatus
string
- OPSSTATUSPENDING: In rare cases, system may not start operation when it was requested. Client will be notified that operation is PENDING - OPSSTATUSONGOING:…

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

zededa-assetgroupservice-api-openapi.yml Raw ↑

Other APIs Zededa publishes across the network.

Zededa AppProfileService API
Zededa ArtifactManager API
Zededa BulkJobOps API
Zededa CertificateEnrollmentProfileConfiguration API
Zededa CloudDiagnostics API
Zededa ClusterGroups API
Zededa ClusterStatus API
Zededa DatastoreConfiguration API
Zededa EdgeApplicationConfiguration API
Zededa EdgeApplicationInstanceConfiguration API
Zededa EdgeApplicationInstanceStatus API
Zededa EdgeDiagnostics API