> ## Documentation Index > Fetch the complete documentation index at: https://docs.textql.com/llms.txt > Use this file to discover all available pages before exploring further. # Get Organization Settings ## OpenAPI ````yaml api-reference/speakeasy/textql-api-with-code-samples.yaml POST /textql.rpc.public.settings.SettingsService/GetOrganizationSettings openapi: 3.1.0 info: title: TextQL API version: 1.0.0 description: | TextQL public API. Generated from protobuf service definitions; internal endpoints are excluded via google.api.visibility / file_visibility. servers: - url: https://app.textql.com/rpc/public security: - apiKey: [] tags: - name: DashboardService - name: AppService description: |- AppService manages data apps: the generative app execution primitive. An app is agent-authored single-file HTML/JS/CSS executing in a CSP sandbox, fed a snapshot of its declared data sources. First-class resource, not a dashboard. - name: ConnectorService - name: PowerBIService - name: TableauService - name: DatasetService - name: OntologyManagementService - name: ChatService - name: AgentService - name: AuditLogService - name: MCPService - name: MetricsExportService - name: ObservabilityService - name: PlaybookService - name: RBACService description: RBAC service for managing roles, permissions, and access control - name: SandboxAdminService - name: SandboxQueryService - name: SandboxCapabilityService - name: SandboxExecService - name: ScimService - name: SecretService - name: SettingsService - name: SlackService - name: TeamsService paths: /textql.rpc.public.settings.SettingsService/GetOrganizationSettings: post: tags: - SettingsService summary: GetOrganizationSettings operationId: SettingsService_GetOrganizationSettings parameters: - name: Connect-Protocol-Version in: header required: true schema: $ref: '#/components/schemas/connect-protocol-version' - name: Connect-Timeout-Ms in: header schema: $ref: '#/components/schemas/connect-timeout-header' requestBody: content: application/json: schema: $ref: >- #/components/schemas/textql.rpc.public.settings.GetOrganizationSettingsRequest required: true responses: '200': description: Success content: application/json: schema: $ref: >- #/components/schemas/textql.rpc.public.settings.GetOrganizationSettingsResponse default: description: Error content: application/json: schema: $ref: '#/components/schemas/connect.error' x-codeSamples: - lang: typescript label: TypeScript (SDK) source: |- import { Textql } from "@textql/sdk"; const textql = new Textql({ apiKey: process.env["TEXTQL_API_KEY"] ?? "", }); async function run() { const result = await textql.settings.get({ body: {}, }); console.log(result); } run(); - lang: python label: Python (SDK) source: |- import os from textql_sdk import Textql with Textql( api_key=os.getenv("TEXTQL_API_KEY", ""), ) as textql: res = textql.settings.get(body={}) # Handle response print(res) components: schemas: connect-protocol-version: type: number title: Connect-Protocol-Version enum: - 1 description: Define the version of the Connect protocol const: 1 default: 1 connect-timeout-header: type: number title: Connect-Timeout-Ms description: Define the timeout, in ms textql.rpc.public.settings.GetOrganizationSettingsRequest: type: object title: GetOrganizationSettingsRequest additionalProperties: false textql.rpc.public.settings.GetOrganizationSettingsResponse: type: object properties: organization: $ref: '#/components/schemas/textql.rpc.auth.Organization' title: organization title: GetOrganizationSettingsResponse additionalProperties: false connect.error: type: object properties: code: type: string examples: - not_found enum: - canceled - unknown - invalid_argument - deadline_exceeded - not_found - already_exists - permission_denied - resource_exhausted - failed_precondition - aborted - out_of_range - unimplemented - internal - unavailable - data_loss - unauthenticated description: >- The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code]. message: type: string description: >- A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client. details: type: array items: $ref: '#/components/schemas/connect.error_details.Any' description: >- A list of messages that carry the error details. There is no limit on the number of messages. title: Connect Error additionalProperties: true description: >- Error type returned by Connect: https://connectrpc.com/docs/go/errors/#http-representation textql.rpc.auth.Organization: type: object properties: orgId: type: string title: org_id slackTeamId: type: string title: slack_team_id nullable: true slackKey: type: string title: slack_key nullable: true defaultConnectorId: type: integer title: default_connector_id format: int32 description: 'Deprecated: use default_connector_ids instead' nullable: true deprecated: true limitDataVisibility: type: boolean title: limit_data_visibility requireAttached: type: boolean title: require_attached nullable: true organizationName: type: string title: organization_name createdAt: $ref: '#/components/schemas/google.protobuf.Timestamp' title: created_at updatedAt: $ref: '#/components/schemas/google.protobuf.Timestamp' title: updated_at organizationLogoUrl: type: string title: organization_logo_url nullable: true emailAllowedDomains: type: array items: type: string title: email_allowed_domains allowedAuthMethods: type: array items: type: string title: allowed_auth_methods theme: $ref: '#/components/schemas/textql.rpc.auth.Theme' title: theme nullable: true orgMeta: type: string title: org_meta nullable: true injectWholeOntologyDisableSearch: type: boolean title: inject_whole_ontology_disable_search nullable: true warning: type: string title: warning nullable: true publicPreview: type: boolean title: public_preview chatV5Cutover: type: boolean title: chat_v5_cutover defaultParadigmMode: $ref: '#/components/schemas/textql.rpc.paradigm_params.ParadigmType' title: default_paradigm_mode nullable: true secretsEnabled: type: boolean title: secrets_enabled emailPollingEnabled: type: boolean title: email_polling_enabled nullable: true logoUrl: type: string title: logo_url nullable: true brandName: type: string title: brand_name nullable: true paradigmParams: $ref: '#/components/schemas/textql.rpc.paradigm_params.ParadigmParams' title: paradigm_params defaultLlmModel: type: integer title: default_llm_model format: int32 nullable: true preferredProvider: type: string title: preferred_provider nullable: true systemDefaultModel: type: integer title: system_default_model format: int32 description: >- Model MODEL_DEFAULT resolves to for this org; SYSTEM_DEFAULT_MODEL env var can override it. nullable: true toolRestrictions: $ref: '#/components/schemas/textql.rpc.paradigm_params.ParadigmParams' title: tool_restrictions nullable: true consoleAccess: type: boolean title: console_access nullable: true defaultConnectorIds: type: array items: type: integer format: int32 title: default_connector_ids hideToolCells: type: boolean title: hide_tool_cells nullable: true disableEmojis: type: boolean title: disable_emojis nullable: true hideExampleConnectors: type: boolean title: hide_example_connectors nullable: true trainingMode: type: boolean title: training_mode nullable: true dashboardsEnabled: type: boolean title: dashboards_enabled nullable: true billingAdminId: type: string title: billing_admin_id nullable: true methodologyEnabled: type: boolean title: methodology_enabled nullable: true allowAllApiAccess: type: boolean title: allow_all_api_access nullable: true feedEnabled: type: boolean title: feed_enabled nullable: true contextV3Enabled: type: boolean title: context_v3_enabled nullable: true bashEnabled: type: boolean title: bash_enabled nullable: true defaultRoutingEnabled: type: boolean title: default_routing_enabled nullable: true enabledModelIds: type: array items: type: integer format: int32 title: enabled_model_ids restrictedModelIds: type: array items: type: integer format: int32 title: restricted_model_ids restrictedFamilies: type: array items: type: string title: restricted_families discoverable: type: boolean title: discoverable nullable: true observabilityEnabled: type: boolean title: observability_enabled nullable: true notificationsEnabled: type: boolean title: notifications_enabled nullable: true clientDbOverrideEnabled: type: boolean title: client_db_override_enabled nullable: true contextReviewRequired: type: boolean title: context_review_required nullable: true googleConnectorEnabled: type: boolean title: google_connector_enabled nullable: true hideApiConnectors: type: boolean title: hide_api_connectors nullable: true fastModeEnabled: type: boolean title: fast_mode_enabled nullable: true maxThinkingEnabled: type: boolean title: max_thinking_enabled nullable: true sandboxStateRetentionDays: type: integer title: sandbox_state_retention_days format: int32 nullable: true sandboxLeaseConfigEnabled: type: boolean title: sandbox_lease_config_enabled nullable: true deleteInactiveThreadsEnabled: type: boolean title: delete_inactive_threads_enabled nullable: true threadRetentionDays: type: integer title: thread_retention_days format: int32 nullable: true threadHardDeleteGraceDays: type: integer title: thread_hard_delete_grace_days format: int32 nullable: true assetUrlExpiry: $ref: '#/components/schemas/textql.rpc.auth.AssetUrlExpiry' title: asset_url_expiry emailOutputEnabled: type: boolean title: email_output_enabled description: >- Mirror of the email_output_enabled feature flag (in feature_flags table, not on the organization row). Surfaces in settings UIs alongside the org-row toggles. nullable: true defaultPlaybookPrivate: type: boolean title: default_playbook_private nullable: true defaultDashboardOutput: type: boolean title: default_dashboard_output nullable: true defaultMethodology: type: integer title: default_methodology format: int32 description: |- Org-wide default response methodology for new chats, as a textql.rpc.public.chat.Methodology enum value (int to avoid an import cycle with the public package). 0 = UNKNOWN/unset -> ADAPTIVE. Overridable per-member (Member.default_methodology) and per-chat. nullable: true scimNewGroupDefaultRoleType: type: string title: scim_new_group_default_role_type nullable: true groupsFeatureEnabled: type: boolean title: groups_feature_enabled nullable: true availableProviders: type: array items: type: string title: available_providers showTextqlUsage: type: boolean title: show_textql_usage description: >- When true, the ANA_INTERNAL ("TextQL Usage") connector includes @textql.com staff activity in its usage views; when false (default) they are filtered out. nullable: true tracesEnabled: type: boolean title: traces_enabled nullable: true allowLlmDataRetention: type: boolean title: allow_llm_data_retention nullable: true soxDbSessionMetadataEnabled: type: boolean title: sox_db_session_metadata_enabled nullable: true smsEnabled: type: boolean title: sms_enabled nullable: true scimAssignDefaultRole: type: boolean title: scim_assign_default_role nullable: true migrationBannerDismissed: type: boolean title: migration_banner_dismissed description: dismiss legacy-context migration banner org-wide nullable: true configMigrationsEnabled: type: boolean title: config_migrations_enabled description: >- Deprecated: superseded by config_objects_enabled (field 80); no longer populated. nullable: true deprecated: true sandboxObservabilityEnabled: type: boolean title: sandbox_observability_enabled nullable: true dataAppsEnabled: type: boolean title: data_apps_enabled description: >- Internal gate for the data apps feature (apps resource + html generative dashboards). nullable: true issuesEnabled: type: boolean title: issues_enabled nullable: true configObjectsEnabled: type: boolean title: config_objects_enabled description: >- config_objects feature_flags row: umbrella switch for all config-managed-object behavior — Ana's authoring tools, the export RPC + capabilities, reconcile takeover. Supersedes config_migrations_enabled (field 74). nullable: true configObjectsPlaybooksEnabled: type: boolean title: config_objects_playbooks_enabled description: >- Per-type sub-toggles under config_objects: playbooks-as-files / dashboards-as-files. Effective only while config_objects_enabled is on; no feature_flags row means enabled. nullable: true configObjectsDashboardsEnabled: type: boolean title: config_objects_dashboards_enabled nullable: true configAutofixEnabled: type: boolean title: config_autofix_enabled description: >- Deprecated: never populated. The autofix sweep no longer has a per-org opt-in — it runs for every org with the config-object checks surface on. Retained only because proto/api is additive-only. nullable: true deprecated: true helmChartVersion: type: string title: helm_chart_version nullable: true spendTransparencyEnabled: type: boolean title: spend_transparency_enabled description: >- Internal flag: show dollar costs (spend transparency) across the product. Only rendered for internal (@textql.com) users while pricing is verified. nullable: true sharingDisabled: type: boolean title: sharing_disabled nullable: true appWritebackAutoApproveEnabled: type: boolean title: app_writeback_auto_approve_enabled description: >- Auto-merge Data App editor writeback config patches (recommended on); when off the writeback opens a reviewable patch instead. nullable: true title: Organization additionalProperties: false connect.error_details.Any: type: object properties: type: type: string description: >- A URL that acts as a globally unique identifier for the type of the serialized message. For example: `type.googleapis.com/google.rpc.ErrorInfo`. This is used to determine the schema of the data in the `value` field and is the discriminator for the `debug` field. value: type: string format: binary description: >- The Protobuf message, serialized as bytes and base64-encoded. The specific message type is identified by the `type` field. debug: oneOf: - type: object title: Any additionalProperties: true description: Detailed error information. discriminator: propertyName: type title: Debug description: >- Deserialized error detail payload. The 'type' field indicates the schema. This field is for easier debugging and should not be relied upon for application logic. additionalProperties: true description: >- Contains an arbitrary serialized message along with a @type that describes the type of the serialized message, with an additional debug field for ConnectRPC error details. google.protobuf.Timestamp: type: string examples: - '2023-01-15T01:30:15.01Z' - '2024-12-25T12:00:00Z' format: date-time description: >- A Timestamp represents a point in time independent of any time zone or local calendar, encoded as a count of seconds and fractions of seconds at nanosecond resolution. The count is relative to an epoch at UTC midnight on January 1, 1970, in the proleptic Gregorian calendar which extends the Gregorian calendar backwards to year one. All minutes are 60 seconds long. Leap seconds are "smeared" so that no leap second table is needed for interpretation, using a [24-hour linear smear](https://developers.google.com/time/smear). The range is from 0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z. By restricting to that range, we ensure that we can convert to and from [RFC 3339](https://www.ietf.org/rfc/rfc3339.txt) date strings. # Examples Example 1: Compute Timestamp from POSIX `time()`. Timestamp timestamp; timestamp.set_seconds(time(NULL)); timestamp.set_nanos(0); Example 2: Compute Timestamp from POSIX `gettimeofday()`. struct timeval tv; gettimeofday(&tv, NULL); Timestamp timestamp; timestamp.set_seconds(tv.tv_sec); timestamp.set_nanos(tv.tv_usec * 1000); Example 3: Compute Timestamp from Win32 `GetSystemTimeAsFileTime()`. FILETIME ft; GetSystemTimeAsFileTime(&ft); UINT64 ticks = (((UINT64)ft.dwHighDateTime) << 32) | ft.dwLowDateTime; // A Windows tick is 100 nanoseconds. Windows epoch 1601-01-01T00:00:00Z // is 11644473600 seconds before Unix epoch 1970-01-01T00:00:00Z. Timestamp timestamp; timestamp.set_seconds((INT64) ((ticks / 10000000) - 11644473600LL)); timestamp.set_nanos((INT32) ((ticks % 10000000) * 100)); Example 4: Compute Timestamp from Java `System.currentTimeMillis()`. long millis = System.currentTimeMillis(); Timestamp timestamp = Timestamp.newBuilder().setSeconds(millis / 1000) .setNanos((int) ((millis % 1000) * 1000000)).build(); Example 5: Compute Timestamp from Java `Instant.now()`. Instant now = Instant.now(); Timestamp timestamp = Timestamp.newBuilder().setSeconds(now.getEpochSecond()) .setNanos(now.getNano()).build(); Example 6: Compute Timestamp from current time in Python. timestamp = Timestamp() timestamp.GetCurrentTime() # JSON Mapping In JSON format, the Timestamp type is encoded as a string in the [RFC 3339](https://www.ietf.org/rfc/rfc3339.txt) format. That is, the format is "{year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z" where {year} is always expressed using four digits while {month}, {day}, {hour}, {min}, and {sec} are zero-padded to two digits each. The fractional seconds, which can go up to 9 digits (i.e. up to 1 nanosecond resolution), are optional. The "Z" suffix indicates the timezone ("UTC"); the timezone is required. A proto3 JSON serializer should always use UTC (as indicated by "Z") when printing the Timestamp type and a proto3 JSON parser should be able to accept both UTC and other timezones (as indicated by an offset). For example, "2017-01-15T01:30:15.01Z" encodes 15.01 seconds past 01:30 UTC on January 15, 2017. In JavaScript, one can convert a Date object to this format using the standard [toISOString()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString) method. In Python, a standard `datetime.datetime` object can be converted to this format using [`strftime`](https://docs.python.org/2/library/time.html#time.strftime) with the time format spec '%Y-%m-%dT%H:%M:%S.%fZ'. Likewise, in Java, one can use the Joda Time's [`ISODateTimeFormat.dateTime()`]( http://joda-time.sourceforge.net/apidocs/org/joda/time/format/ISODateTimeFormat.html#dateTime() ) to obtain a formatter capable of generating timestamps in this format. textql.rpc.auth.Theme: type: object properties: bg: type: string title: bg headerBg: type: string title: header_bg cardBg: type: string title: card_bg primaryAccent: type: string title: primary_accent cardAccent: type: string title: card_accent heading: type: string title: heading text: type: string title: text cardHeading: type: string title: card_heading cardText: type: string title: card_text logoUrl: type: string title: logo_url nullable: true docsUrl: type: string title: docs_url nullable: true title: Theme additionalProperties: false textql.rpc.paradigm_params.ParadigmType: type: string title: ParadigmType enum: - TYPE_UNKNOWN - TYPE_UNIVERSAL textql.rpc.paradigm_params.ParadigmParams: type: object properties: webSearchEnabled: type: boolean title: web_search_enabled sqlEnabled: type: boolean title: sql_enabled ontologyEnabled: type: boolean title: ontology_enabled pythonEnabled: type: boolean title: python_enabled powerbiEnabled: type: boolean title: powerbi_enabled googleDriveEnabled: type: boolean title: google_drive_enabled formEditorEnabled: type: boolean title: form_editor_enabled tableauEnabled: type: boolean title: tableau_enabled fileUploadEnabled: type: boolean title: file_upload_enabled multipleConnectorMode: type: boolean title: multiple_connector_mode deprecated: true playbookToolsEnabled: type: boolean title: playbook_tools_enabled microsoft365Enabled: type: boolean title: microsoft_365_enabled bashEnabled: type: boolean title: bash_enabled javascriptEnabled: type: boolean title: javascript_enabled modelSwitchingEnabled: type: boolean title: model_switching_enabled feedExplorerEnabled: type: boolean title: feed_explorer_enabled feedPostEnabled: type: boolean title: feed_post_enabled feedCommentEnabled: type: boolean title: feed_comment_enabled feedEngageEnabled: type: boolean title: feed_engage_enabled compactionDisabled: type: boolean title: compaction_disabled gmailEnabled: type: boolean title: gmail_enabled chatHistorySearchEnabled: type: boolean title: chat_history_search_enabled googleCalendarEnabled: type: boolean title: google_calendar_enabled parallelToolsEnabled: type: boolean title: parallel_tools_enabled emailOutputEnabled: type: boolean title: email_output_enabled questionsToolEnabled: type: boolean title: questions_tool_enabled powerbiSelections: type: array items: $ref: '#/components/schemas/textql.rpc.powerbi_selection.PowerBISelection' title: powerbi_selections datasetId: type: string title: dataset_id description: >- Per-chat/agent options: registers the EmailCell tool (default off, opt-in). Org tool_restrictions: allows the Email tool org-wide (default on). nullable: true title: ParadigmParams additionalProperties: false textql.rpc.auth.AssetUrlExpiry: type: string title: AssetUrlExpiry enum: - EXPIRY_NONE - EXPIRY_ONE_DAY - EXPIRY_SEVEN_DAYS - EXPIRY_THIRTY_DAYS - EXPIRY_ONE_YEAR - EXPIRY_FIFTEEN_MINUTES - EXPIRY_ONE_HOUR - EXPIRY_SIX_HOURS - EXPIRY_TWELVE_HOURS description: >- Values are the organization.asset_url_expiry column values — do not renumber. textql.rpc.powerbi_selection.PowerBISelection: type: object properties: workspaceId: type: string title: workspace_id reportIds: type: array items: type: string title: report_ids datasetIds: type: array items: type: string title: dataset_ids workspaceName: type: string title: workspace_name connectorId: type: integer title: connector_id format: int32 title: PowerBISelection additionalProperties: false description: |- PowerBISelection captures a chosen PowerBI workspace (and optionally the specific reports/datasets within it) for attaching to a chat. Field shape mirrors textql.rpc.public.paradigm.PowerBISelection; kept in a standalone package so it can be shared by paradigm_params without an import cycle (public/paradigm.proto already imports paradigm_params.proto). securitySchemes: apiKey: type: apiKey in: header name: tql_api_key ````