Settings API

Sending, storage, logo

How the company’s mail leaves — Yet’s Amazon SES or its own — the bucket Drive keeps its files in, and its logo.

Base URL https://acme.yet.com.br/api/settings

Settings answer at your company’s own address — acme here — and take a key of someone who runs them.

Get sending

GET/api/settings/sending

Which SES the mail leaves through, and whether Yet’s is open to the company.

Who: Runs the company’s Settings

Request

curl https://acme.yet.com.br/api/settings/sending \
  -H "Authorization: Bearer $YET_API_KEY"

Response · 200

{
  "sending": "yet",
  "ses_allowed": true
}

Set sending

PUT/api/settings/sending

yet, Yet’s SES; or own, the company’s, through its AWS account.

Who: Runs the company’s Settings

Body

sending"yet" | "own"required: Which SES.

Request

curl -X PUT https://acme.yet.com.br/api/settings/sending \
  -H "Authorization: Bearer $YET_API_KEY" \
  -d '{
    "sending": "own"
  }'

Get Drive’s bucket

GET/api/settings/storage

Its bucket and folder, or null while Drive keeps the files itself.

Who: Runs the company’s Settings

Request

curl https://acme.yet.com.br/api/settings/storage \
  -H "Authorization: Bearer $YET_API_KEY"

Response · 200

{
  "storage": {
    "bucket": "acme-drive",
    "prefix": "files"
  }
}

Set Drive’s bucket

PUT/api/settings/storage

In the company’s AWS account; written to once, to be sure it works.

Who: Runs the company’s Settings

Body

bucketstringrequired: The bucket.
prefixstring: A folder in it.

Request

curl -X PUT https://acme.yet.com.br/api/settings/storage \
  -H "Authorization: Bearer $YET_API_KEY"

Remove Drive’s bucket

DELETE/api/settings/storage

Its files stay in it.

Who: Runs the company’s Settings

Request

curl -X DELETE https://acme.yet.com.br/api/settings/storage \
  -H "Authorization: Bearer $YET_API_KEY"

Get the logo

GET/api/settings/logo

Its type and bytes, in base64 — or null, Yet’s mark.

Who: Runs the company’s Settings

Request

curl https://acme.yet.com.br/api/settings/logo \
  -H "Authorization: Bearer $YET_API_KEY"

Response · 200

{
  "logo": {
    "content_type": "image/png",
    "data": "iVBORw0KGgo…"
  }
}

Set the logo

PUT/api/settings/logo

Shown on the sign-in page: PNG, JPEG, WebP, GIF or SVG, up to 256 KB.

Who: Runs the company’s Settings

Body

content_typestringrequired: Its type.
datastringrequired: Its bytes, in base64.

Request

curl -X PUT https://acme.yet.com.br/api/settings/logo \
  -H "Authorization: Bearer $YET_API_KEY"

Remove the logo

DELETE/api/settings/logo

Back to Yet’s mark.

Who: Runs the company’s Settings

Request

curl -X DELETE https://acme.yet.com.br/api/settings/logo \
  -H "Authorization: Bearer $YET_API_KEY"