Group Domains

Retrieve the list of assigned domains

GET /api/v1/tenants/(string: tenant_id)/groups/(string: group_id)/domains/

Get the list of assigned domains to the group along with group’s default domain.

Example request:

Authorization Right:minimum Group Admin.

GET /api/v1/tenants/foo/groups/foogroup/domains/ HTTP/1.1
Host: example.com

Example response:

HTTP/1.1 200 OK
Content-Type: "application/json"

{
   "defaultDomain": "netaxis.sip.be",
   "domains": [
      "netaxis.sip.be",
      "customer.com"
   ]
}
Response JSON Object:

  • defaultDomain (string) – The default domain name assigned to the group.

  • domains (array) – The list of domain names assigned to the group.

Status Codes:

Assign new domains

PUT /api/v1/tenants/(string: tenant_id)/groups/(string: group_id)/domains/

Assign new domains to the group.

Example request:

Authorization Right:minimum Group Admin.

Template Actions: this end point is available as template action under the name group_assign_domains

PUT /api/v1/tenants/foo/groups/foogroup/domains/ HTTP/1.1
Host: example.com
Content-Type: "application/json"

{
   "domains": [
      "netaxis.be"
   ]
}
Request JSON Object:

  • domains (array) – (Required) The list of domain names to assign to the group. The domain names must already be defined at tenant’s level.

Example response:

Response:

Similar to GET instance method response.

Status Codes:

Un-assign existing domains

DELETE /api/v1/tenants/(string: tenant_id)/groups/(string: group_id)/domains/

Un-assign domains from the group.

Example request:

Authorization Right:minimum Group Admin.

DELETE /api/v1/tenants/foo/groups/foogroup/domains/ HTTP/1.1
Host: example.com
Content-Type: "application/json"

{
   "domains": [
      "netaxis.be"
   ]
}
Request JSON Object:

  • domains (array) – (Required) The list of domain names to un-assign from the group.

Example response:

HTTP/1.1 200 OK
Content-Type: "application/json"

{}
Status Codes: