Organization API: Org Staff Views

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.

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

List the saved views you can use: your own, then every view the team shared.

Each view is { id, entity, name, query, shared, pinned, mine, owner_name, schedule, recipients, created_at, updated_at }. Your views come first, then the rest, each group by name. Any member of the organization can read them. The recipients of a report you did not save are shown to billing and higher only.

POST /api/v1/orgs/{org_slug}/staff/views

Save the filters of a list under a name.

Any member can save a view for themselves, read-only members included. Sharing a view with the team needs Tier 3 support or higher. Mailing a report (schedule and recipients, for entity report only) needs billing or higher. You can keep 50 views for each list.

application/json (required)

PATCH /api/v1/orgs/{org_slug}/staff/views/{view_id}

Change a view you saved: its name, filters, sharing, pin, schedule or recipients.

Only the person who saved a view can change it; anyone else gets a 404. The same rules as saving apply: sharing needs Tier 3 support and mailing a report needs billing. Send schedule as null to stop mailing.

application/json (required)

DELETE /api/v1/orgs/{org_slug}/staff/views/{view_id}

Delete a view you saved. Only the person who saved it can; anyone else gets a 404.