Skip to content
Coritan Docs

Organization API: Org Staff Digest

Every Organization API operation tagged Org Staff Digest.

View as Markdown

Base URL: https://api.coritan.com/api/v1. Paths below are complete.

To try these requests in the browser, open the interactive Organization API reference.

Method Path Summary
GET /api/v1/orgs/{org_slug}/staff/digest Which digest the signed-in member gets: off, daily or weekly
PUT /api/v1/orgs/{org_slug}/staff/digest Choose the signed-in member's digest: off, daily or weekly
GET /api/v1/orgs/{org_slug}/staff/digest/preview Staff preview digest

Which digest the signed-in member gets: off, daily or weekly

Section titled Which digest the signed-in member gets: off, daily or weekly

GET /api/v1/orgs/{org_slug}/staff/digest

Which digest the signed-in member gets: off, daily or weekly.

can_receive is false for a role below billing, since a digest holds money figures, and reason then says who can. send_time and timezone say when it arrives: 07:00 in the brand's timezone, on Monday for a weekly one.

Name In Type Required
org_slug path string yes
Status Meaning
200 Success.
422 The request is not valid. detail lists each problem.

Choose the signed-in member's digest: off, daily or weekly

Section titled Choose the signed-in member's digest: off, daily or weekly

PUT /api/v1/orgs/{org_slug}/staff/digest

Choose the signed-in member's digest: off, daily or weekly.

Billing, admins and the owner can choose daily or weekly; any other role is refused with a 403 that says who can. Anyone can choose off. A digest chosen after 07:00 starts with the next send, and choosing the word already set changes nothing.

Name In Type Required
org_slug path string yes

application/json (required)

Field Type Required
kind string yes
Status Meaning
200 Success.
422 The request is not valid. detail lists each problem.

GET /api/v1/orgs/{org_slug}/staff/digest/preview

The digest email the member would get, as a web page, built from the last period that ended: yesterday for daily, or the last whole week (Monday to Sunday) for weekly.

Needs billing or above, because a digest holds money figures. The page is sandboxed and never cached.

Name In Type Required Description
org_slug path string yes
kind query string no Which digest to preview: daily, weekly. Default: daily.
Status Meaning
200 Success.
422 The request is not valid. detail lists each problem.