Skip to main content
Use this quickstart to prepare a terminal, CI job, or trusted agent runtime for TextMine command-line work. This page focuses on configuration and first safe checks. Use the install command and command reference supplied with the CLI release or the developer hub for the exact command names in your version.

​
1. Choose the environment

Use the Public API base URL and MCP URL for the TextMine environment you are allowed to access. For the public UK multitenant deployment:
For a dedicated deployment, use the values supplied by TextMine. Do not infer the API URL from a web app URL unless the setup guide explicitly says to do that.

​
2. Choose an authentication method

Use one of the supported authentication paths. For direct/private automation, store a TextMine API key outside model-visible context:
For OAuth-enabled marketplace or shared-host flows, use the OAuth flow from that app or setup guide and store the resulting access token in the runtime’s approved secret store. OAuth client registrations can use:
Do not paste API keys, OAuth tokens, refresh tokens, or client secrets into prompts, screenshots, tickets, source code, shell history, or shared documentation.

​
3. Run read-only checks first

Before running commands that create or update TextMine data, confirm the CLI can complete low-risk checks for the configured environment: If any check returns an unexpected organization, empty Vault list, or authentication error, stop and fix the environment or credential before running mutating commands.

​
4. Use the right surface

​
5. Keep CLI output audit-friendly

For support and audit trails, capture non-secret identifiers in CLI output:
  • Organization or environment label.
  • Vault ID and document ID.
  • Workflow ID and run ID.
  • Record schema ID and record ID.
  • Task ID and task event IDs.
Do not capture raw credentials. If a command prints a secret by mistake, treat the output as sensitive and rotate the credential if needed. Next, read TextMine MCP server for MCP setup details or Agent self-service signup for service-account onboarding.
Last modified on July 7, 2026