Skip to documentation
Documentation
Documentation
OverviewInstallationQuickstartYour first dayYou were sent a linkWorking with a customerConfigurationTroubleshootingFAQGlossary

Usage

Terminal interfaceCLIStatuslineDashboardAnalytics

Collaborate

DocumentsLessonsSession sharingPicking up tomorrow and handing work overFrom your phoneSession linksSession messagingAsksAsks privacy fact sheetFeedbackEmail from crewkitBlueprintsAgent identitiesMCP server

Configure

AgentsSkillsSkill and agent security scanningRulesCommandsInheritancePlaybooksExperimentsHooksCapture modesSensitive sessionsData residencyTeamSettings mapIntegrations

Workspaces

WorkspacesSet up a workspaceFix a ticket end to endShip a feature with approvalHand off work and set agent settings

API Reference

API OverviewAuthenticationSessions APIResources APIOrganizations APIProjects APIPlaybooks APIExperiments API
Need a hand?Find an answer in troubleshooting.
Loading docs…
CREWKIT / DOCUMENTATION

Settings map

The settings listed here, the level it applies at, who may change it, its default and what changing it stops.

A setting applies at one level: the organization, a project, a repository or a person. A lower level can narrow some organization settings, but cannot loosen any. This page lists each setting once, with its default, the lowest role that may change it and what changing it does.

Roles, from most to least privileged: Owner, Admin, Manager, Developer, Viewer. "Manager and up" means Manager, Admin or Owner. What each role reads is on Team.


Organization

Changed in Settings → Organization unless the row says otherwise. These apply to every project and every member of the organization.

SettingDefaultWho changes itWhat changing it does
Capture Mode (capture_mode), on the Privacy & Telemetry cardstructuredAdmin and upDecides how much session content crewkit collects; see Capture modes. Moving to minimal also strips the text of stored pull request and issue records.
Data Retention Period (retention_days), same card365 daysAdmin and up, between 7 and 365 daysSession content older than this is deleted by the next retention sweep.
Default language (default_locale)EnglishManager and upThe organization's default language, English or French.
Email subjects (minimal_subjects)offManager and upDecides what a notification email shows on a lock screen before anyone opens it.
Asks opt-in, with Asks: keeping Responses (asks_response_retention_days) and Asks: never send outsideoff; 180 daysAdmin and upTurns Asks on or off, sets how long Responses are kept (30 to 365 days) and the names that must not leave the organization, such as clients and codenames, which the text check flags before an Ask is published. Choosing a new Asks domain asks for a fresh dashboard sign-in.
Managers may publish Asks (asks_managers_may_publish)offAdmin and upWhile off, only an Admin or Owner publishes an Ask.
Feedback opt-in, retention (feedback_retention_days) and session triage (feedback_session_triage_enabled)off; 180 days; off

Team

Invite teammates, give each one a role, and see what each role can do.

Integrations

The tools crewkit connects to, grouped by the level they connect at, with who may connect each one, what it reads and writes, and where its steps are.

On this page

OrganizationAPI onlyProjectWhat you cannot set per projectRepositoryPersonSet by crewkit, not by your organizationNext steps
Admin and up
Turns Feedback on or off and sets how long reports are kept (30 to 365 days). Session triage can be turned on from the dashboard only, never from a CLI token.
Data residency, on the Data Plane cardhostedAdmin and up, on a plan that includes itMoves session content to the organization's own data plane; see Data residency.
Session linksSession messaging offAdmin and upDecides whether sessions can link and message each other; see Session messaging.

API only

These organization settings have no dashboard control. An Admin or Owner changes them with PATCH /api/v1/<org>/telemetry/settings.

SettingDefaultWhat changing it does
retain_prompts, retain_tool_calls, retain_responses, retain_tool_resultsall onTurning one off stops crewkit writing that category of transcript content down, and hides what was already written from transcripts, the API and share links.
correction_analysis_enabledoffTurning it on allows correction detection on the organization's conversations.
plane_derived_rows_enabledoffFor a resident organization: whether its data plane may send per-session scores and token counts back to crewkit.

Project

Changed in the project's Settings unless the row says otherwise.

SettingDefaultWho changes itWhat changing it does
Name, Jira key, Slack channel idsnoneManager and up; a workspace's lead may rename it and change its Jira key and work Slack channelRenames the project, and sets where work items find Jira cards and post to Slack. Creating a project takes Developer and up; deleting one, Admin and up.
Presencefollows the organizationManager and upNarrows who sees live sessions on this project. It cannot widen the organization's setting.
Playbook assignmentsnone: the organization's playbooks applyManager and up to add, Admin and up to removeScopes which playbooks apply to this project.
Feedback keysnoneDeveloper and up to create; Manager and up, or the key's own creator, to revokeA revoked key stops accepting reports. See Feedback keys.
Feedback daily cap (feedback_daily_cap)200 per dayManager and up, from 1 to 1,000, with the MCP tool set_feedback_daily_capThe most reports the project accepts in a UTC day.

What you cannot set per project

  • Capture mode
  • Retention
  • Data residency

Each is set once for the whole organization; a project has no setting for any of them. The narrower controls are a repository's session visibility (below) and a sensitive session. Ask an Admin or Owner to change the organization's setting.


Repository

SettingDefaultWho changes itWhat changing it does
Session visibility: Public, Restricted or PrivatePublicManager and up for Public or Restricted; Admin and up for Private. Through the API onlyHides conversations in that repository from lower roles and keeps them out of analysis and project search; see What feeds analysis.

Person

SettingDefaultWho changes itWhat changing it does
Sensitive session (crewkit code --sensitive)offThe person, per launchMarks that one session sensitive; see Sensitive sessions.

Set by crewkit, not by your organization

  • Lessons. An organization gets Lessons only when a crewkit platform owner turns it on for that organization. No one in your organization can turn it on. Ask crewkit support.

Next steps

  • Integrations: what each connected tool reads and writes, and who connects it.
  • Team: roles and what each reads.