Account

Switch the account's workspace role.

Your workspace role (Screenwriter, Content creator or Business) decides how the workspace leans: which areas show, how Slug coaches you, and what kind of project New Project starts with (a Screenwriter's is always a story; product projects are for Content creator and Business). One account and one Studio Credit balance across every role. Switching is allowed only on accounts an admin has turned it on for, and every switch is recorded. 403 role_switch_not_enabled unless an admin allowed this account to switch (state: asking again changes nothing). The same role twice changes nothing and records nothing (changed: false). Credits, projects, Slug's persona and the craft focus stay. Audited. Scope: account:write. Free.

put/account/workspace-role

Request

  • Base URL: https://docs.sleeperhit.studio/api/v1
  • URL: https://docs.sleeperhit.studio/api/v1/account/workspace-role
  • Auth: HTTP bearer

Request body

role'writer' | 'creator' | 'business' required

writer (Screenwriter), creator (Content creator) or business (Business).

Response

The role now, and whether it changed.

role'writer' | 'creator' | 'business' | 'null' nullable required

Null until first-run onboarding has picked a track.

labelstring nullable required

"Screenwriter", "Content creator" or "Business".

workspaceTrackstring nullable required

The stored track the role is read from (professional_writer | storyteller).

creatorContextstring nullable required

The stored creator context the role is read from (self | company).

craftFocus'screenwriter' | 'novelist' | 'advertiser' | 'brand_marketer' | 'content_creator' | 'comms' | 'founder' | 'journalist' | 'null' nullable required

The craft focus Slug coaches toward (set it with PUT /account/craft-focus). A switch never changes it.

canSwitchboolean required

Whether an admin allowed this account to switch its role.

defaultProjectKind'story' | 'product' required

The kind a new project starts as when none is named.

changedboolean required

False when the account already had the role: nothing was written or recorded.

previousRole'writer' | 'creator' | 'business' | 'null' nullable required

Changes

No recorded changes to this operation across all 2 revisions of this API.