Manage Organizations

Overview

An Organization (Org) is the primary resource boundary in WEDA — devices, container stacks, and users all belong to an Org. This tutorial walks through listing, creating, and deleting Orgs using the 1-Org&ClientCred Postman collection, and ensures org_id is set in your environment for use in later collections.

---

Prerequisites

• Completed Get Access Token — accessToken must be set in your environment.

---

Auto-captured Variables

After running these requests, the following variable is automatically set in your environment:

Variable	Set by	Used by
org_id	Org Create, or Org List (the org whose name matches your login)	Collections 2 and 4
org_name	Org Create	Org Delete

---

Requests in This Collection

These three requests are independent CRUD operations — you do not need to run all of them, and there is no fixed order. Use whichever fits your situation. The only requirement before moving on to Collection 2 is that org_id is set in your environment.

---

Org Create(Create a new organization)

Creates a new organization. The request Body is pre-filled (the org name defaults to your {{login}}, plus a description) — you can send it as-is or edit the name first.

• API: Create Organization
• Script: org_id and org_name saved to environment automatically
• Result: 201 Created

---

Org List(Get organizations)

Lists all organizations you have permission to view.

• API: Get Organizations
• Script: org_id set to the org whose name matches your {{login}} automatically
• Result: 200 OK

提示

If an org already exists in your environment, run Org List to confirm which org org_id is pointing to before proceeding.

---

Org Delete(Delete an organization)

Deletes the organization currently stored in org_id. This request also uses org_name (set by Org Create) as a confirmation query parameter, so run Org Create first if it is not set.

• API: Delete Organization
• Result: 204 No Content

注意

Deletion is irreversible. Make sure the org has no active devices or running container stacks before deleting. Deleting an org with active resources will fail.

---

Before Moving On

org_id must be set in your environment before running Collection 2. It is captured automatically by either Org Create or Org List — run whichever applies to your setup and verify the value in your environment before proceeding.

Related

• For API details and developer reference: Organization Management

---

Last updated on Aug-2, 2026 | Version 1.1.1