Skip to navigation

Get

The workspace’s settings, as Settings → Workspace shows them. Requires organization:read.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Response

This endpoint returns an object.
idstring
namestring
slugstring

The workspace’s address, as in taktoria.com/app/{slug}. Unique across Taktoria.

whitelabelboolean
The workspace's own name and icon stand in for Taktoria's in the app.
fiscalYearStartMonthinteger

The calendar month (1 to 12) the fiscal year, and so Q1, starts in. Every app that talks in quarters reads it: OKR Hub’s periods, and LaunchCal’s “Launched this quarter”.

okrYearslist of integers

The fiscal years OKR Hub offers in its period pickers and on the scorecard besides the current one, which it always offers. Newest first; empty for the current year alone.

holidayMarketslist of strings

The countries, as ISO codes (US, GB), whose public holidays LaunchCal shows on its calendar and warns about when a launch is planned on one. The United States until somebody picks; empty for none. See GET /holidays.

requireGoogleSignInboolean

Members must be signed in with Google to open the workspace. A session made any other way is refused by the API with google_sign_in_required; keys are unaffected. It also makes every go link and Dory event set to DOMAIN take Google’s word alone, whatever its own requireGoogle says: their requireGoogle then reads true.

slackCommandsWithoutGoogleboolean

Allow Slack commands without Google sign-in, under Require sign-in with Google in Settings → Workspace. Slack cannot sign in with Google, so while Google is required, Taktoria’s Slack commands act only for somebody who has connected their Slack account by signing in with Google once (see GET /slack-connections). On, they take the address Slack has confirmed instead, as in a workspace that does not require Google. It means nothing while requireGoogleSignIn is false. Off by default.

googleSignInAvailableboolean

Whether Google sign-in is set up on this installation, so it can be required.

autoGrowSeatsboolean

Add seats as people join, in Settings → Domains. While a verified domain has autoJoin on, somebody who joins gets their default seat on an app even when its seats are all taken, and the seats paid for rise by one (seatsPaid on the subscription; Stripe’s quantity follows, prorated). Off, that app is skipped: the newcomer goes on its waiting list (GET /seats/waiting), and owners and admins are emailed who is waiting. It does nothing while no domain has autoJoin on. On by default.

allowCalendarFeedsboolean

Allow calendar feeds, in Settings → Workspace: whether members may subscribe to LaunchCal from Google Calendar, Outlook or Apple Calendar. A feed is a private address read with no sign-in, around Require Google sign-in and single sign-on, so a workspace that holds every way in to those turns it off: every feed then answers 404 and none can be made, until it is on again. On by default. Feeds themselves have no API: each address is a person’s secret.

defaultTimeZonestringOptional

The IANA zone picked to start with wherever a time zone is asked, such as a Dory event’s, and what an event created through the API without one is given. Absent for none (UTC there).

Errors

401
Unauthorized Error
403
Forbidden Error
429
Too Many Requests Error