# MCP tool reference 1 callable tools. Use tools/call at https://mcp.schedulerzero.com/mcp with the exact tool name and arguments below. The /tools/ paths in this view are documentation identifiers, not HTTP endpoints. Request execution is disabled for this reference. Inputs are shown for personal API keys (bound) and for OAuth/delegated agents. Output schemas describe MCP structuredContent: native objects pass through; arrays, scalars and null use a data wrapper. Text content retains the native JSON result. [Connect a client](/mcp/connect) · [Authentication and authorization](/authentication) · [Generated auth guide](/auth.md) · [Download tool catalog](/mcp-catalog.json) · [Agent documentation](/llms.txt) ## share_call_recordings Publish a recorded call outside the workspace under a capability link, read whether one is already published, and revoke it. Use when a specific recorded conversation has to reach someone who cannot sign in — a coach, a customer, a reviewer — and the person asking has decided that is appropriate. A share link is a standing grant to listen to a real customer conversation, and revoking it cannot un-hear it. Masking the prospect's voice reduces casual recognition; it is not anonymization, and the transcript still carries every word. Never create one speculatively, never create one to work around a missing permission, and always confirm with a person first. Obtain the user's explicit authorization before invoking a write or destructive action. This is a client interaction requirement, not a server-issued approval token. Scopes: dialer:update Risk: destructive; confirmation: explicit; idempotency: supported. ### Input schema (personal API key) ```json { "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$", "format": "uuid" }, "callId": { "type": "string", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$", "format": "uuid" }, "action": { "type": "string", "enum": [ "read", "create", "revoke" ] }, "create": { "type": "object", "properties": { "access": { "type": "string", "enum": [ "workspace", "anyone_with_link" ] }, "privacy": { "type": "string", "enum": [ "show_all", "hide_lead", "hide_rep", "hide_both" ] }, "audioPrivacy": { "type": "string", "enum": [ "original", "mask_prospect" ] } }, "required": [ "access", "privacy", "audioPrivacy" ], "patternProperties": { "^(?!(?:access|privacy|audioPrivacy)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "access", "privacy", "audioPrivacy" ] } } }, "required": [ "workspaceId", "callId", "action" ], "patternProperties": { "^(?!(?:workspaceId|callId|action|create)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "workspaceId", "callId", "action", "create" ] } } ``` ### Input schema (OAuth / delegated agent) ```json { "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$", "format": "uuid" }, "callId": { "type": "string", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$", "format": "uuid" }, "action": { "type": "string", "enum": [ "read", "create", "revoke" ] }, "create": { "type": "object", "properties": { "access": { "type": "string", "enum": [ "workspace", "anyone_with_link" ] }, "privacy": { "type": "string", "enum": [ "show_all", "hide_lead", "hide_rep", "hide_both" ] }, "audioPrivacy": { "type": "string", "enum": [ "original", "mask_prospect" ] } }, "required": [ "access", "privacy", "audioPrivacy" ], "patternProperties": { "^(?!(?:access|privacy|audioPrivacy)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "access", "privacy", "audioPrivacy" ] } } }, "required": [ "workspaceId", "callId", "action" ], "patternProperties": { "^(?!(?:workspaceId|callId|action|create)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "workspaceId", "callId", "action", "create" ] } } ``` ### Output schema (structuredContent) ```json { "$defs": { "RecordingShareToken": { "type": "string", "pattern": "^[A-Za-z0-9_-]{32}$" }, "UtcDateTimeEncoded": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$" } }, "type": "object", "anyOf": [ { "allOf": [ { "anyOf": [ { "type": "object", "properties": { "share": { "anyOf": [ { "type": "object", "properties": { "token": { "$ref": "#/$defs/RecordingShareToken" }, "callId": { "type": "string", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$", "format": "uuid" }, "access": { "type": "string", "enum": [ "workspace", "anyone_with_link" ] }, "privacy": { "type": "string", "enum": [ "show_all", "hide_lead", "hide_rep", "hide_both" ] }, "audioPrivacy": { "type": "string", "enum": [ "original", "mask_prospect" ] }, "audioStatus": { "type": "string", "enum": [ "ready", "processing", "failed" ] } }, "required": [ "token", "callId", "access", "privacy", "audioPrivacy", "audioStatus" ], "patternProperties": { "^(?!(?:token|callId|access|privacy|audioPrivacy|audioStatus)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "token", "callId", "access", "privacy", "audioPrivacy", "audioStatus" ] } }, { "type": "null" } ] } }, "required": [ "share" ], "patternProperties": { "^(?!(?:share)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "anyOf": [ { "type": "string", "enum": [ "share" ] } ] } }, { "type": "object", "properties": { "token": { "$ref": "#/$defs/RecordingShareToken" }, "callId": { "type": "string", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$", "format": "uuid" }, "access": { "type": "string", "enum": [ "workspace", "anyone_with_link" ] }, "privacy": { "type": "string", "enum": [ "show_all", "hide_lead", "hide_rep", "hide_both" ] }, "audioPrivacy": { "type": "string", "enum": [ "original", "mask_prospect" ] }, "audioStatus": { "type": "string", "enum": [ "ready", "processing", "failed" ] } }, "required": [ "token", "callId", "access", "privacy", "audioPrivacy", "audioStatus" ], "patternProperties": { "^(?!(?:token|callId|access|privacy|audioPrivacy|audioStatus)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "token", "callId", "access", "privacy", "audioPrivacy", "audioStatus" ] } }, { "type": "object", "properties": { "callId": { "type": "string", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$", "format": "uuid" }, "revokedAt": { "$ref": "#/$defs/UtcDateTimeEncoded" } }, "required": [ "callId", "revokedAt" ], "patternProperties": { "^(?!(?:callId|revokedAt)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "callId", "revokedAt" ] } } ] }, { "type": "object" } ] }, { "type": "object", "properties": { "data": { "allOf": [ { "anyOf": [ { "type": "object", "properties": { "share": { "anyOf": [ { "type": "object", "properties": { "token": { "$ref": "#/$defs/RecordingShareToken" }, "callId": { "type": "string", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$", "format": "uuid" }, "access": { "type": "string", "enum": [ "workspace", "anyone_with_link" ] }, "privacy": { "type": "string", "enum": [ "show_all", "hide_lead", "hide_rep", "hide_both" ] }, "audioPrivacy": { "type": "string", "enum": [ "original", "mask_prospect" ] }, "audioStatus": { "type": "string", "enum": [ "ready", "processing", "failed" ] } }, "required": [ "token", "callId", "access", "privacy", "audioPrivacy", "audioStatus" ], "patternProperties": { "^(?!(?:token|callId|access|privacy|audioPrivacy|audioStatus)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "token", "callId", "access", "privacy", "audioPrivacy", "audioStatus" ] } }, { "type": "null" } ] } }, "required": [ "share" ], "patternProperties": { "^(?!(?:share)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "anyOf": [ { "type": "string", "enum": [ "share" ] } ] } }, { "type": "object", "properties": { "token": { "$ref": "#/$defs/RecordingShareToken" }, "callId": { "type": "string", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$", "format": "uuid" }, "access": { "type": "string", "enum": [ "workspace", "anyone_with_link" ] }, "privacy": { "type": "string", "enum": [ "show_all", "hide_lead", "hide_rep", "hide_both" ] }, "audioPrivacy": { "type": "string", "enum": [ "original", "mask_prospect" ] }, "audioStatus": { "type": "string", "enum": [ "ready", "processing", "failed" ] } }, "required": [ "token", "callId", "access", "privacy", "audioPrivacy", "audioStatus" ], "patternProperties": { "^(?!(?:token|callId|access|privacy|audioPrivacy|audioStatus)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "token", "callId", "access", "privacy", "audioPrivacy", "audioStatus" ] } }, { "type": "object", "properties": { "callId": { "type": "string", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$", "format": "uuid" }, "revokedAt": { "$ref": "#/$defs/UtcDateTimeEncoded" } }, "required": [ "callId", "revokedAt" ], "patternProperties": { "^(?!(?:callId|revokedAt)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "callId", "revokedAt" ] } } ] }, { "not": { "type": "object" } } ] } }, "required": [ "data" ], "additionalProperties": false } ] } ``` ### Underlying API operations - `dialerRecordings.shareState`: `GET /v1/workspaces/:workspaceId/dialer/calls/:callId/recording-share` - `dialerRecordings.createShare`: `POST /v1/workspaces/:workspaceId/dialer/calls/:callId/recording-share` - `dialerRecordings.revokeShare`: `DELETE /v1/workspaces/:workspaceId/dialer/calls/:callId/recording-share`