sf_connection_manage
Manage connections to Salesforce orgs associated with the user's Cirra AI account. Call cirra_ai_init at least once before using this tool.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | The action to perform. Options: 'list' (list all connections), 'describe' (provide details of the connection, including org info and current org limits such as data/file storage, daily API request usage, async job slots, etc.), 'add' (add a new connection), 'reauthenticate' (refresh auth for a connection), 'remove' (remove a connection) | |
| sf_user | No | (optional) Salesforce username to identify the connection to use. Omit this to use the current default connection. | |
| cirra_ai_team | No | (optional) Cirra team ID or name that owns the Salesforce connection to use for this call. Must be provided together with 'sf_user'. Use it to run against a specific team's connection without changing your default team — e.g. to keep separate chats on Salesforce orgs in different teams. Omit it when this call carries the context_handle from cirra_ai_init, which names the team for the conversation. A user with more than one place to work (several teams, or a team and a personal account) must pass either the context_handle or 'cirra_ai_team' + 'sf_user'. | |
| context_handle | No | (recommended) The conversation context handle returned by cirra_ai_init in this conversation. Pass the exact context_handle value from the most recent cirra_ai_init result so this call runs against the team and Salesforce connection selected for this conversation. A user with more than one place to work (several Cirra AI teams, or a team and a personal account) must pass either this handle or 'cirra_ai_team' + 'sf_user'; a call with neither is refused. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | No | Action-specific payload: connection details object (describe), array of connection objects (list), array of per-environment authorization URL entries with markdown links (add), a single authorization URL entry (reauthenticate), or the removed connection (remove) | |
| message | Yes | Human-readable summary of the result | |
| success | Yes | Whether the operation succeeded | |
| warning | No | Optional warning about the current connection or result | |
| instructions | No | Follow-up instructions for the client, e.g. asking the user to open an authorization URL |