Skip to content

Organizations

Manage organizations (available to partners).

Commands

orgs list

List organizations with pagination and search.

1
mysecutec orgs list [flags]

Flags

Flag Type Default Description
--page int 1 Page number
--per-page int 20 Results per page
--search string Search filter

API

1
GET /org/v1/organizations?page=1&per_page=20

Request Example

1
mysecutec orgs list --per-page 5 --search "acme"

1
2
3
GET /org/v1/organizations?page=1&per_page=5&search=acme
Authorization: Bearer <token>
Accept: application/json

Response

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
{
  "items": [
    {
      "id": "org-uuid-123",
      "name": "Acme Corporation",
      "alias": "acme",
      "domains": [
        { "name": "acme.com", "verified": true },
        { "name": "acme.be", "verified": false }
      ],
      "pro_license": true,
      "is_partner": false,
      "business_unit_id": "bu-uuid-456",
      "business_unit": {
        "id": "bu-uuid-456",
        "slug": "enterprise",
        "label": "Enterprise"
      },
      "disabled": false,
      "created_at": "2024-01-15T10:00:00Z",
      "updated_at": "2025-06-15T14:00:00Z"
    }
  ],
  "totalItems": 42
}

Model: Organization

Field Type Description
id string (UUID) Organization ID
name string Organization name
alias string Short alias
domains []OrgDomain Associated domains
pro_license bool Whether Pro license is active
is_partner bool Whether this is a partner org
business_unit_id string Business unit ID
business_unit BusinessUnit Business unit details
disabled bool Whether org is disabled
created_at timestamp Creation timestamp
updated_at timestamp Last update timestamp

Model: OrgDomain

Field Type Description
name string Domain name
verified bool Whether domain is verified

Model: BusinessUnit

Field Type Description
id string Business unit ID
slug string URL-friendly slug
label string Display label

Model: OrganizationListResponse

Field Type Description
items []Organization Organization list
totalItems int Total count

orgs license-modules

List the license modules enabled for the active context (your own org, or the one you are impersonating).

1
mysecutec orgs license-modules

API

1
GET /org/v1/license-modules

Request Example

1
mysecutec orgs license-modules

1
2
3
GET /org/v1/license-modules
Authorization: Bearer <token>
Accept: application/json

Response

1
2
3
4
5
[
  { "acronym": "XDR", "name": "Extended detection and response", "enabled": true },
  { "acronym": "SDNS", "name": "SecureDNS", "enabled": true },
  { "acronym": "Bitsight", "name": "Bitsight Security Ratings", "enabled": false }
]

Model: LicenseModule

Field Type Description
acronym string Module acronym
name string Module display name
enabled bool Whether the module is licensed

orgs impersonation-tree

Show the partners and their clients available for impersonation. Each node's ID can be passed to mysecutec impersonate <id>.

1
mysecutec orgs impersonation-tree

API

1
GET /org/v1/organizations/impersonation-tree

Request Example

1
mysecutec orgs impersonation-tree

1
2
3
GET /org/v1/organizations/impersonation-tree
Authorization: Bearer <token>
Accept: application/json

Response

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
{
  "partners": [
    {
      "id": "partner-uuid-1",
      "name": "Acme Partner",
      "alias": "acme",
      "is_partner": true,
      "can_impersonate": true,
      "clients": [
        { "id": "client-uuid-9", "name": "Client BVBA", "alias": "client", "is_partner": false, "can_impersonate": true }
      ]
    }
  ]
}

Model: ImpersonationTreeNode

Field Type Description
id string Organization ID (use with impersonate)
name string Organization name
alias string Short alias
is_partner bool Whether the node is a partner
can_impersonate bool Whether you may impersonate it

Partner nodes additionally carry a clients array of the same shape.