Skip to content
Console
Menu

Getting Started

Authentication

KV Store

Mailbox OAUTH apps

A Mailbox OAuth App is the platform customer's own OAuth client at Google or Microsoft.

A Mailbox OAuth App is the platform customer's own OAuth client at Google or Microsoft. End users consent to it, so the consent screen names the customer's app and never Sylphx, and every OAUTH mailbox of its provider in the environment refreshes its grant against it. An environment has at most one per provider.

Service Sylphx Notify · Resource type notify.sylphx.com/MailboxOauthApp · Name pattern orgs/{org}/projects/{project}/envs/{env}/mailbox_oauth_apps/{mailbox_oauth_app} · Shape spec_status

#Fields

FieldTypeWhat it is
namestringorgs/{org}/projects/{project}/envs/{env}/mailbox_oauth_apps/{mailbox_oauth_app}.
uidstringmoa_<cell><ulid>; never reused. Output only.
metaResourceMetaResource metadata.
specMailboxOauthAppSpecDesired state. Required.
statusMailboxOauthAppStatusObserved state. Output only.

#Methods

Every method of the collection, in the registry's order, with the scope it needs. The full request, response and examples are one link away.

MethodCallWhat it does
GETgetGets a mailbox OAuth app.
GETlistLists mailbox OAuth apps.
POSTcreateCreates a mailbox OAuth app.
PATCHupdateUpdates a mailbox OAuth app.
DELETEdeleteDeletes a mailbox OAuth app; refused while a mailbox uses it.

#get

Gets a mailbox OAuth app.

GET https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/mailbox_oauth_apps/mailbox-oauth-app · scope notify:read · effect read · Request, response and examples

#list

Lists mailbox OAuth apps.

GET https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/mailbox_oauth_apps · scope notify:read · effect read · paginated · Request, response and examples

#create

Creates a mailbox OAuth app.

POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/mailbox_oauth_apps · scope notify:write · effect write · Request, response and examples

#update

Updates a mailbox OAuth app.

PATCH https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/mailbox_oauth_apps/mailbox-oauth-app · scope notify:write · effect write · Request, response and examples

#delete

Deletes a mailbox OAuth app; refused while a mailbox uses it.

DELETE https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/mailbox_oauth_apps/mailbox-oauth-app · scope notify:write · effect destructive · Request, response and examples