How to Use the ZEDEDA API

Introduction

The Edge Infrastructure Services API lets you manage infrastructure programmatically using any HTTP client, scripting language, or CI/CD tool. All requests require a Bearer token in the Authorization header. For token generation, programmatic authentication, token scope, expiry, and security best practices, see Authentication.

Make an API Request

Include your token in the Authorization header of every request:

Authorization: Bearer YOUR_API_TOKEN

For example, to retrieve a list of edge nodes:

curl -X GET \
  'https://zedcontrol.zededa.net/api/v1/devices?adminState=UNSPECIFIED' \
  --header 'Authorization: Bearer YOUR_API_TOKEN' \
  --header 'Content-Type: application/json'

Replace zedcontrol.zededa.net with your enterprise’s Edge Infrastructure Services URL and YOUR_API_TOKEN with your token. For the full list of available endpoints, request parameters, and response schemas, see the API Reference.

Next Steps

Authentication: Generate tokens, authenticate programmatically, and manage token security.
Errors: HTTP error codes and how to resolve them.
API Reference: Full endpoint documentation for Edge Infrastructure Services.
ZEDEDA Terraform Provider: Manage infrastructure as code using your API token.
User Events API: Query user lifecycle events programmatically.

API guides

API services

Introduction

Make an API Request

Next Steps

​Introduction

​Make an API Request

​Next Steps

Introduction

Make an API Request

Next Steps