Connector health
connectors.health.v2
Use when: Check whether HubSpot, Apollo, email, or LinkedIn connectors are connected.
Avoid when: Do not use this for credit balance — that is workspace.status.get.v2.
Effects: Reads current workspace state.
Cost: No gateway credit charge; reads saved workspace data without starting paid provider work. Gateway rate code: none; downstream billing may apply.
Access: runs:read. Approval: operation authorization. Reads do not need an operation UUID.
Keep the same operation and operation_id when retrying identical work. Reconcile an uncertain result before new work; never replay an old V1 write under a new V2 ID.
Check status, execution_state, error_code, output and evidence/resource references. Queued work is not complete: poll jobs.status.get.v2 in domain.workspace.v2. For read-back verification require read_back_verified=true where returned; reconcile failures without creating another object.
Invocation example using fictional fixtures
{
"tool": "domain.workspace.v2",
"arguments": {
"params": {
"action": "invoke",
"operation": "connectors.health.v2",
"arguments": {},
"operation_id": "00000000-0000-4000-8000-000000000003"
}
},
"notice": "Fictional fixture IDs and example text. Resolve real IDs, use returned preview tokens and approve exact side effects before execution. Input validation is not proof of provider readiness or a successful business outcome."
}Input schema: fields, defaults and constraints
{
"additionalProperties": false,
"properties": {
"providers": {
"default": [],
"description": "Providers used by the public connectors health input v2 operation.",
"items": {
"type": "string"
},
"maxItems": 20,
"title": "Providers",
"type": "array"
}
},
"title": "McpPublicConnectorsHealthInputV2",
"type": "object"
}Output schema inside the result envelope
{
"$defs": {
"ConnectorHealthV1": {
"additionalProperties": false,
"properties": {
"connection_id": {
"format": "uuid",
"title": "Connection Id",
"type": "string"
},
"provider": {
"maxLength": 40,
"minLength": 1,
"title": "Provider",
"type": "string"
},
"status": {
"enum": [
"connected",
"degraded",
"error",
"disconnected",
"unknown"
],
"title": "Status",
"type": "string"
},
"last_validated_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Last Validated At"
},
"last_successful_sync_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Last Successful Sync At"
},
"issue_summary": {
"anyOf": [
{
"maxLength": 500,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Issue Summary"
}
},
"required": [
"connection_id",
"provider",
"status"
],
"title": "ConnectorHealthV1",
"type": "object"
}
},
"additionalProperties": false,
"description": "V2 result for connectors.health.v2; preserves the established validators.",
"properties": {
"connectors": {
"default": [],
"items": {
"$ref": "#/$defs/ConnectorHealthV1"
},
"maxItems": 20,
"title": "Connectors",
"type": "array"
}
},
"title": "PublicConnectorsHealthResultV2",
"type": "object"
}