EmailConfigApi
extends ManagementSupport
in package
Transactional-mail transport, configurable at organization level and overridable per tenant.
The email_config namespace handle (CONTRACT.md §27.2), reached as
$client->management()->emailConfig(). Every method here goes through the one shared ManagementTransport, so §3 CSRF, the §4 cookie jar, the §5 tenant header, §6 TLS, §16 retry
and §19 telemetry apply without this class doing anything to opt in (§27.8).
Table of Contents
Methods
- __construct() : mixed
- deleteOrg() : void
- `DELETE /api/v1/organizations/{org_id}/email-config`
- deleteTenant() : void
- `DELETE /api/v1/tenants/{tenant_id}/email-config`
- forTenant() : static
- A COPY of this handle scoped to `$tenantId` (§27.4 rule 3). See {@see self::inOrg()} for why it copies.
- getOrg() : EmailConfig
- `GET /api/v1/organizations/{org_id}/email-config`
- getTenant() : EmailConfigOverride
- `GET /api/v1/tenants/{tenant_id}/email-config`
- inOrg() : static
- A COPY of this handle scoped to `$orgId` (§27.4 rule 3).
- setOrg() : EmailConfig
- `PUT /api/v1/organizations/{org_id}/email-config`
- setTenant() : EmailConfigOverride
- `PUT /api/v1/tenants/{tenant_id}/email-config`
- testOrg() : EmailTestResult
- `POST /api/v1/organizations/{org_id}/email-config/test`
- testTenant() : EmailTestResult
- `POST /api/v1/tenants/{tenant_id}/email-config/test`
Methods
__construct()
public
__construct(ManagementTransport $transport[, NamespaceScope $scope = new NamespaceScope() ][, string|null $clientOrgId = null ][, string|null $clientTenantId = null ]) : mixed
Parameters
- $transport : ManagementTransport
-
The one wire path (§27.8).
- $scope : NamespaceScope = new NamespaceScope()
-
Per-handle
{org_id}/{tenant_id}overrides. - $clientOrgId : string|null = null
-
The client's own organization id, or
null. - $clientTenantId : string|null = null
-
The client's own tenant id, or
null.
deleteOrg()
`DELETE /api/v1/organizations/{org_id}/email-config`
public
deleteOrg() : void
DELETE /api/v1/organizations/{org_id}/email-config.
Returns nothing; the server answers with an empty body.
NOT idempotent (§27.4 rule 6): deleting something already deleted raises NotFoundError rather than succeeding quietly.
deleteTenant()
`DELETE /api/v1/tenants/{tenant_id}/email-config`
public
deleteTenant() : void
DELETE /api/v1/tenants/{tenant_id}/email-config.
Returns nothing; the server answers with an empty body.
NOT idempotent (§27.4 rule 6): deleting something already deleted raises NotFoundError rather than succeeding quietly.
forTenant()
A COPY of this handle scoped to `$tenantId` (§27.4 rule 3). See {@see self::inOrg()} for why it copies.
public
forTenant(string $tenantId) : static
Parameters
- $tenantId : string
Return values
staticgetOrg()
`GET /api/v1/organizations/{org_id}/email-config`
public
getOrg() : EmailConfig
GET /api/v1/organizations/{org_id}/email-config.
Return values
EmailConfiggetTenant()
`GET /api/v1/tenants/{tenant_id}/email-config`
public
getTenant() : EmailConfigOverride
GET /api/v1/tenants/{tenant_id}/email-config.
Return values
EmailConfigOverrideinOrg()
A COPY of this handle scoped to `$orgId` (§27.4 rule 3).
public
inOrg(string $orgId) : static
Returns a new handle rather than mutating this one. An administrator holding a handle to their own organization should not find it repointed at someone else's because an unrelated code path re-scoped a shared object — and on a management surface that failure mode writes to the wrong tenant rather than merely reading from it.
Parameters
- $orgId : string
Return values
staticsetOrg()
`PUT /api/v1/organizations/{org_id}/email-config`
public
setOrg(SetOrgEmailConfig $body) : EmailConfig
PUT /api/v1/organizations/{org_id}/email-config.
Parameters
- $body : SetOrgEmailConfig
-
the request body
Return values
EmailConfigsetTenant()
`PUT /api/v1/tenants/{tenant_id}/email-config`
public
setTenant(EmailConfigOverride $body) : EmailConfigOverride
PUT /api/v1/tenants/{tenant_id}/email-config.
Parameters
- $body : EmailConfigOverride
-
the request body
Return values
EmailConfigOverridetestOrg()
`POST /api/v1/organizations/{org_id}/email-config/test`
public
testOrg() : EmailTestResult
POST /api/v1/organizations/{org_id}/email-config/test.
Return values
EmailTestResulttestTenant()
`POST /api/v1/tenants/{tenant_id}/email-config/test`
public
testTenant() : EmailTestResult
POST /api/v1/tenants/{tenant_id}/email-config/test.