# 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) ## verify_contacts Verify email addresses or phone numbers through the workspace's connected verifier waterfall; single calls confirm inline, bulk calls enqueue a durable run. Use when asked to check whether an email or phone is valid before sending; bulk accepts explicit lists or a campaign scope and returns an operation handle. Never verify without a connected workspace verifier key; the run bills the workspace's own provider account, so confirm spend before bulk submission. 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: emailVerification:verify, phoneVerification:verify, emailVerification:read, phoneVerification:read Risk: costly; 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" }, "channel": { "type": "string", "enum": [ "email", "phone" ] }, "mode": { "type": "string", "enum": [ "single", "bulk" ] }, "email": { "$ref": "#/$defs/EmailAddress" }, "phone": { "$ref": "#/$defs/PhoneNumberInput" }, "emails": { "type": "array", "items": { "$ref": "#/$defs/EmailAddress" }, "maxItems": 10000 }, "phones": { "type": "array", "items": { "$ref": "#/$defs/PhoneNumberInput" }, "maxItems": 10000 }, "scope": { "type": "object", "properties": { "campaignId": { "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" }, "search": { "$ref": "#/$defs/ShortText" }, "assigneeUserIds": { "type": "array", "items": { "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" } } }, "required": [ "campaignId" ], "patternProperties": { "^(?!(?:campaignId|search|assigneeUserIds)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "campaignId", "search", "assigneeUserIds" ] } }, "forceRecheck": { "type": "boolean" } }, "required": [ "workspaceId", "channel", "mode" ], "patternProperties": { "^(?!(?:workspaceId|channel|mode|email|phone|emails|phones|scope|forceRecheck)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "workspaceId", "channel", "mode", "email", "phone", "emails", "phones", "scope", "forceRecheck" ] }, "$defs": { "EmailAddress": { "type": "string", "minLength": 3, "maxLength": 320, "pattern": "^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$" }, "PhoneNumberInput": { "type": "string", "minLength": 1, "maxLength": 64 }, "ShortText": { "type": "string", "minLength": 1, "maxLength": 256 } } } ``` ### 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" }, "channel": { "type": "string", "enum": [ "email", "phone" ] }, "mode": { "type": "string", "enum": [ "single", "bulk" ] }, "email": { "$ref": "#/$defs/EmailAddress" }, "phone": { "$ref": "#/$defs/PhoneNumberInput" }, "emails": { "type": "array", "items": { "$ref": "#/$defs/EmailAddress" }, "maxItems": 10000 }, "phones": { "type": "array", "items": { "$ref": "#/$defs/PhoneNumberInput" }, "maxItems": 10000 }, "scope": { "type": "object", "properties": { "campaignId": { "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" }, "search": { "$ref": "#/$defs/ShortText" }, "assigneeUserIds": { "type": "array", "items": { "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" } } }, "required": [ "campaignId" ], "patternProperties": { "^(?!(?:campaignId|search|assigneeUserIds)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "campaignId", "search", "assigneeUserIds" ] } }, "forceRecheck": { "type": "boolean" } }, "required": [ "workspaceId", "channel", "mode" ], "patternProperties": { "^(?!(?:workspaceId|channel|mode|email|phone|emails|phones|scope|forceRecheck)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "workspaceId", "channel", "mode", "email", "phone", "emails", "phones", "scope", "forceRecheck" ] }, "$defs": { "EmailAddress": { "type": "string", "minLength": 3, "maxLength": 320, "pattern": "^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$" }, "PhoneNumberInput": { "type": "string", "minLength": 1, "maxLength": 64 }, "ShortText": { "type": "string", "minLength": 1, "maxLength": 256 } } } ``` ### Output schema (structuredContent) ```json { "$defs": { "EmailAddress": { "type": "string", "minLength": 3, "maxLength": 320, "pattern": "^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$" }, "ShortText": { "type": "string", "minLength": 1, "maxLength": 256 }, "UtcDateTimeEncoded": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$" }, "HttpUrl": { "type": "string", "minLength": 1, "maxLength": 2048, "pattern": "^https?:\\/\\/[^\\s/$.?#][^\\s]*$" }, "HttpResourcePath": { "type": "string", "minLength": 1, "maxLength": 2048, "pattern": "^\\/[A-Za-z0-9._~!$&'()*+,;=:@/%-]*$" }, "NonEmptyString": { "type": "string", "minLength": 1, "maxLength": 4096 } }, "type": "object", "anyOf": [ { "allOf": [ { "anyOf": [ { "type": "object", "properties": { "email": { "$ref": "#/$defs/EmailAddress" }, "status": { "type": "string", "enum": [ "valid", "invalid", "catch-all", "unknown", "disposable", "role", "spamtrap" ] }, "source": { "type": "string", "enum": [ "cache", "dns", "provider" ] }, "provider": { "anyOf": [ { "$ref": "#/$defs/ShortText" }, { "type": "null" } ] }, "confidence": { "anyOf": [ { "type": "number", "minimum": 0, "maximum": 100 }, { "type": "null" } ] }, "flags": { "type": "object", "properties": { "role": { "type": "boolean" }, "disposable": { "type": "boolean" }, "spamtrap": { "type": "boolean" }, "freeProvider": { "type": "boolean" } }, "patternProperties": { "^(?!(?:role|disposable|spamtrap|freeProvider)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "role", "disposable", "spamtrap", "freeProvider" ] } }, "verifiedAt": { "anyOf": [ { "$ref": "#/$defs/UtcDateTimeEncoded" }, { "type": "null" } ] }, "fromCache": { "type": "boolean" }, "attempts": { "type": "array", "items": { "type": "object", "properties": { "providerId": { "$ref": "#/$defs/ShortText" }, "status": { "type": "string", "enum": [ "valid", "invalid", "catch-all", "unknown", "disposable", "role", "spamtrap" ] }, "rawStatus": { "anyOf": [ { "$ref": "#/$defs/ShortText" }, { "type": "null" } ] }, "confidence": { "anyOf": [ { "type": "number", "minimum": 0, "maximum": 100 }, { "type": "null" } ] }, "resolved": { "type": "boolean" } }, "required": [ "providerId", "status", "rawStatus", "confidence", "resolved" ], "patternProperties": { "^(?!(?:providerId|status|rawStatus|confidence|resolved)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "providerId", "status", "rawStatus", "confidence", "resolved" ] } } } }, "required": [ "email", "status", "source", "provider", "confidence", "verifiedAt", "fromCache", "attempts" ], "patternProperties": { "^(?!(?:email|status|source|provider|confidence|flags|verifiedAt|fromCache|attempts)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "email", "status", "source", "provider", "confidence", "flags", "verifiedAt", "fromCache", "attempts" ] } }, { "type": "object", "properties": { "phone": { "$ref": "#/$defs/ShortText" }, "status": { "type": "string", "enum": [ "valid", "invalid", "unknown" ] }, "source": { "type": "string", "enum": [ "cache", "format", "provider" ] }, "provider": { "anyOf": [ { "$ref": "#/$defs/ShortText" }, { "type": "null" } ] }, "confidence": { "anyOf": [ { "type": "number", "minimum": 0, "maximum": 100 }, { "type": "null" } ] }, "flags": { "type": "object", "properties": { "lineType": { "type": "string", "enum": [ "mobile", "landline", "voip", "toll_free", "premium", "unknown" ] }, "carrier": { "$ref": "#/$defs/ShortText" }, "isPrepaid": { "type": "boolean" }, "activityScore": { "anyOf": [ { "type": "number" }, { "type": "string", "enum": [ "Infinity", "-Infinity", "NaN" ] } ] }, "isLitigatorRisk": { "type": "boolean" }, "countryCode": { "$ref": "#/$defs/ShortText" }, "e164Format": { "$ref": "#/$defs/ShortText" } }, "patternProperties": { "^(?!(?:lineType|carrier|isPrepaid|activityScore|isLitigatorRisk|countryCode|e164Format)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "lineType", "carrier", "isPrepaid", "activityScore", "isLitigatorRisk", "countryCode", "e164Format" ] } }, "verifiedAt": { "anyOf": [ { "$ref": "#/$defs/UtcDateTimeEncoded" }, { "type": "null" } ] }, "fromCache": { "type": "boolean" }, "attempts": { "type": "array", "items": { "type": "object", "properties": { "providerId": { "$ref": "#/$defs/ShortText" }, "status": { "type": "string", "enum": [ "valid", "invalid", "catch-all", "unknown", "disposable", "role", "spamtrap" ] }, "rawStatus": { "anyOf": [ { "$ref": "#/$defs/ShortText" }, { "type": "null" } ] }, "confidence": { "anyOf": [ { "type": "number", "minimum": 0, "maximum": 100 }, { "type": "null" } ] }, "resolved": { "type": "boolean" } }, "required": [ "providerId", "status", "rawStatus", "confidence", "resolved" ], "patternProperties": { "^(?!(?:providerId|status|rawStatus|confidence|resolved)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "providerId", "status", "rawStatus", "confidence", "resolved" ] } } } }, "required": [ "phone", "status", "source", "provider", "confidence", "verifiedAt", "fromCache", "attempts" ], "patternProperties": { "^(?!(?:phone|status|source|provider|confidence|flags|verifiedAt|fromCache|attempts)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "phone", "status", "source", "provider", "confidence", "flags", "verifiedAt", "fromCache", "attempts" ] } }, { "type": "object", "properties": { "runId": { "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" }, "queued": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "capped": { "type": "boolean" }, "cap": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "operation": { "type": "object", "properties": { "id": { "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" }, "statusUrl": { "anyOf": [ { "$ref": "#/$defs/HttpUrl" }, { "$ref": "#/$defs/HttpResourcePath" } ] }, "state": { "type": "string", "enum": [ "queued", "running", "waiting_for_user", "succeeded", "partially_succeeded", "failed", "canceled", "canceling" ] }, "acceptedAt": { "$ref": "#/$defs/UtcDateTimeEncoded" }, "progress": { "type": "object", "properties": { "completed": { "type": "integer", "minimum": 0 }, "total": { "type": "integer", "minimum": 0 }, "message": { "$ref": "#/$defs/NonEmptyString" } }, "required": [ "completed" ], "patternProperties": { "^(?!(?:completed|total|message)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "completed", "total", "message" ] } }, "canCancel": { "type": "boolean" } }, "required": [ "id", "statusUrl", "state", "acceptedAt", "canCancel" ], "patternProperties": { "^(?!(?:id|statusUrl|state|acceptedAt|progress|canCancel)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "id", "statusUrl", "state", "acceptedAt", "progress", "canCancel" ] } } }, "required": [ "runId", "queued", "capped", "cap", "operation" ], "patternProperties": { "^(?!(?:runId|queued|capped|cap|operation)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "runId", "queued", "capped", "cap", "operation" ] } }, { "type": "object", "properties": { "runId": { "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" }, "operation": { "type": "object", "properties": { "id": { "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" }, "statusUrl": { "anyOf": [ { "$ref": "#/$defs/HttpUrl" }, { "$ref": "#/$defs/HttpResourcePath" } ] }, "state": { "type": "string", "enum": [ "queued", "running", "waiting_for_user", "succeeded", "partially_succeeded", "failed", "canceled", "canceling" ] }, "acceptedAt": { "$ref": "#/$defs/UtcDateTimeEncoded" }, "progress": { "type": "object", "properties": { "completed": { "type": "integer", "minimum": 0 }, "total": { "type": "integer", "minimum": 0 }, "message": { "$ref": "#/$defs/NonEmptyString" } }, "required": [ "completed" ], "patternProperties": { "^(?!(?:completed|total|message)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "completed", "total", "message" ] } }, "canCancel": { "type": "boolean" } }, "required": [ "id", "statusUrl", "state", "acceptedAt", "canCancel" ], "patternProperties": { "^(?!(?:id|statusUrl|state|acceptedAt|progress|canCancel)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "id", "statusUrl", "state", "acceptedAt", "progress", "canCancel" ] } } }, "required": [ "runId", "operation" ], "patternProperties": { "^(?!(?:runId|operation)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "runId", "operation" ] } } ] }, { "type": "object" } ] }, { "type": "object", "properties": { "data": { "allOf": [ { "anyOf": [ { "type": "object", "properties": { "email": { "$ref": "#/$defs/EmailAddress" }, "status": { "type": "string", "enum": [ "valid", "invalid", "catch-all", "unknown", "disposable", "role", "spamtrap" ] }, "source": { "type": "string", "enum": [ "cache", "dns", "provider" ] }, "provider": { "anyOf": [ { "$ref": "#/$defs/ShortText" }, { "type": "null" } ] }, "confidence": { "anyOf": [ { "type": "number", "minimum": 0, "maximum": 100 }, { "type": "null" } ] }, "flags": { "type": "object", "properties": { "role": { "type": "boolean" }, "disposable": { "type": "boolean" }, "spamtrap": { "type": "boolean" }, "freeProvider": { "type": "boolean" } }, "patternProperties": { "^(?!(?:role|disposable|spamtrap|freeProvider)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "role", "disposable", "spamtrap", "freeProvider" ] } }, "verifiedAt": { "anyOf": [ { "$ref": "#/$defs/UtcDateTimeEncoded" }, { "type": "null" } ] }, "fromCache": { "type": "boolean" }, "attempts": { "type": "array", "items": { "type": "object", "properties": { "providerId": { "$ref": "#/$defs/ShortText" }, "status": { "type": "string", "enum": [ "valid", "invalid", "catch-all", "unknown", "disposable", "role", "spamtrap" ] }, "rawStatus": { "anyOf": [ { "$ref": "#/$defs/ShortText" }, { "type": "null" } ] }, "confidence": { "anyOf": [ { "type": "number", "minimum": 0, "maximum": 100 }, { "type": "null" } ] }, "resolved": { "type": "boolean" } }, "required": [ "providerId", "status", "rawStatus", "confidence", "resolved" ], "patternProperties": { "^(?!(?:providerId|status|rawStatus|confidence|resolved)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "providerId", "status", "rawStatus", "confidence", "resolved" ] } } } }, "required": [ "email", "status", "source", "provider", "confidence", "verifiedAt", "fromCache", "attempts" ], "patternProperties": { "^(?!(?:email|status|source|provider|confidence|flags|verifiedAt|fromCache|attempts)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "email", "status", "source", "provider", "confidence", "flags", "verifiedAt", "fromCache", "attempts" ] } }, { "type": "object", "properties": { "phone": { "$ref": "#/$defs/ShortText" }, "status": { "type": "string", "enum": [ "valid", "invalid", "unknown" ] }, "source": { "type": "string", "enum": [ "cache", "format", "provider" ] }, "provider": { "anyOf": [ { "$ref": "#/$defs/ShortText" }, { "type": "null" } ] }, "confidence": { "anyOf": [ { "type": "number", "minimum": 0, "maximum": 100 }, { "type": "null" } ] }, "flags": { "type": "object", "properties": { "lineType": { "type": "string", "enum": [ "mobile", "landline", "voip", "toll_free", "premium", "unknown" ] }, "carrier": { "$ref": "#/$defs/ShortText" }, "isPrepaid": { "type": "boolean" }, "activityScore": { "anyOf": [ { "type": "number" }, { "type": "string", "enum": [ "Infinity", "-Infinity", "NaN" ] } ] }, "isLitigatorRisk": { "type": "boolean" }, "countryCode": { "$ref": "#/$defs/ShortText" }, "e164Format": { "$ref": "#/$defs/ShortText" } }, "patternProperties": { "^(?!(?:lineType|carrier|isPrepaid|activityScore|isLitigatorRisk|countryCode|e164Format)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "lineType", "carrier", "isPrepaid", "activityScore", "isLitigatorRisk", "countryCode", "e164Format" ] } }, "verifiedAt": { "anyOf": [ { "$ref": "#/$defs/UtcDateTimeEncoded" }, { "type": "null" } ] }, "fromCache": { "type": "boolean" }, "attempts": { "type": "array", "items": { "type": "object", "properties": { "providerId": { "$ref": "#/$defs/ShortText" }, "status": { "type": "string", "enum": [ "valid", "invalid", "catch-all", "unknown", "disposable", "role", "spamtrap" ] }, "rawStatus": { "anyOf": [ { "$ref": "#/$defs/ShortText" }, { "type": "null" } ] }, "confidence": { "anyOf": [ { "type": "number", "minimum": 0, "maximum": 100 }, { "type": "null" } ] }, "resolved": { "type": "boolean" } }, "required": [ "providerId", "status", "rawStatus", "confidence", "resolved" ], "patternProperties": { "^(?!(?:providerId|status|rawStatus|confidence|resolved)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "providerId", "status", "rawStatus", "confidence", "resolved" ] } } } }, "required": [ "phone", "status", "source", "provider", "confidence", "verifiedAt", "fromCache", "attempts" ], "patternProperties": { "^(?!(?:phone|status|source|provider|confidence|flags|verifiedAt|fromCache|attempts)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "phone", "status", "source", "provider", "confidence", "flags", "verifiedAt", "fromCache", "attempts" ] } }, { "type": "object", "properties": { "runId": { "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" }, "queued": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "capped": { "type": "boolean" }, "cap": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "operation": { "type": "object", "properties": { "id": { "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" }, "statusUrl": { "anyOf": [ { "$ref": "#/$defs/HttpUrl" }, { "$ref": "#/$defs/HttpResourcePath" } ] }, "state": { "type": "string", "enum": [ "queued", "running", "waiting_for_user", "succeeded", "partially_succeeded", "failed", "canceled", "canceling" ] }, "acceptedAt": { "$ref": "#/$defs/UtcDateTimeEncoded" }, "progress": { "type": "object", "properties": { "completed": { "type": "integer", "minimum": 0 }, "total": { "type": "integer", "minimum": 0 }, "message": { "$ref": "#/$defs/NonEmptyString" } }, "required": [ "completed" ], "patternProperties": { "^(?!(?:completed|total|message)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "completed", "total", "message" ] } }, "canCancel": { "type": "boolean" } }, "required": [ "id", "statusUrl", "state", "acceptedAt", "canCancel" ], "patternProperties": { "^(?!(?:id|statusUrl|state|acceptedAt|progress|canCancel)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "id", "statusUrl", "state", "acceptedAt", "progress", "canCancel" ] } } }, "required": [ "runId", "queued", "capped", "cap", "operation" ], "patternProperties": { "^(?!(?:runId|queued|capped|cap|operation)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "runId", "queued", "capped", "cap", "operation" ] } }, { "type": "object", "properties": { "runId": { "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" }, "operation": { "type": "object", "properties": { "id": { "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" }, "statusUrl": { "anyOf": [ { "$ref": "#/$defs/HttpUrl" }, { "$ref": "#/$defs/HttpResourcePath" } ] }, "state": { "type": "string", "enum": [ "queued", "running", "waiting_for_user", "succeeded", "partially_succeeded", "failed", "canceled", "canceling" ] }, "acceptedAt": { "$ref": "#/$defs/UtcDateTimeEncoded" }, "progress": { "type": "object", "properties": { "completed": { "type": "integer", "minimum": 0 }, "total": { "type": "integer", "minimum": 0 }, "message": { "$ref": "#/$defs/NonEmptyString" } }, "required": [ "completed" ], "patternProperties": { "^(?!(?:completed|total|message)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "completed", "total", "message" ] } }, "canCancel": { "type": "boolean" } }, "required": [ "id", "statusUrl", "state", "acceptedAt", "canCancel" ], "patternProperties": { "^(?!(?:id|statusUrl|state|acceptedAt|progress|canCancel)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "id", "statusUrl", "state", "acceptedAt", "progress", "canCancel" ] } } }, "required": [ "runId", "operation" ], "patternProperties": { "^(?!(?:runId|operation)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "runId", "operation" ] } } ] }, { "not": { "type": "object" } } ] } }, "required": [ "data" ], "additionalProperties": false } ] } ``` ### Underlying API operations - `emailVerification.single`: `POST /v1/workspaces/:workspaceId/verification/verify` - `emailVerification.bulk`: `POST /v1/workspaces/:workspaceId/verification/verify/bulk` - `emailVerification.status`: `GET /v1/workspaces/:workspaceId/verification/runs/:runId/status` - `phoneVerification.single`: `POST /v1/workspaces/:workspaceId/phone-verification/verify` - `phoneVerification.bulk`: `POST /v1/workspaces/:workspaceId/phone-verification/verify/bulk` - `phoneVerification.status`: `GET /v1/workspaces/:workspaceId/phone-verification/runs/:runId/status`