Composway Docs
Tool reference

Get search-engine connection status

Live: connected Google + Bing accounts, the property/site attached to this site's workspace, and the last time its search data synced.

Tool name: get_connection_status

Cost: Free - not billed, and does not draw on a plan quota.

Read-only

This tool only reads. It never creates or changes anything, so an assistant may call it without asking you first.

Live: connected Google + Bing accounts, the property/site attached to this site's workspace, and the last time its search data synced. Quota is not included - neither engine's quota consumption is tracked today.

Parameters

ParameterTypeRequiredNotes
sitestringYesThe site to look up, as a bare domain ("example.com") or a URL - scheme, www., path and trailing slash are all stripped. Must resolve to a workspace the caller owns; call list_sites first if unsure of the exact domain.
Full input JSON Schema
{
	"$schema": "https://json-schema.org/draft/2020-12/schema",
	"type": "object",
	"properties": {
		"site": {
			"type": "string",
			"minLength": 1,
			"description": "The site to look up, as a bare domain (\"example.com\") or a URL - scheme, www., path and trailing slash are all stripped. Must resolve to a workspace the caller owns; call list_sites first if unsure of the exact domain."
		}
	},
	"required": ["site"]
}

Response

Full output JSON Schema
{
	"$schema": "https://json-schema.org/draft/2020-12/schema",
	"type": "object",
	"properties": {
		"site": {
			"type": "string"
		},
		"workspaceId": {
			"type": "string",
			"format": "uuid",
			"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|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
		},
		"google": {
			"type": "object",
			"properties": {
				"connected": {
					"type": "boolean"
				},
				"credentials": {
					"type": "array",
					"items": {
						"type": "object",
						"properties": {
							"id": {
								"type": "string",
								"format": "uuid",
								"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|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
							},
							"googleAccountEmail": {
								"type": "string"
							},
							"scopes": {
								"type": "string"
							},
							"createdAt": {
								"type": "string"
							},
							"reauthRequiredAt": {
								"anyOf": [
									{
										"type": "string"
									},
									{
										"type": "null"
									}
								]
							}
						},
						"required": [
							"id",
							"googleAccountEmail",
							"scopes",
							"createdAt"
						],
						"additionalProperties": {}
					}
				},
				"selectedProperty": {
					"anyOf": [
						{
							"type": "object",
							"properties": {},
							"additionalProperties": {}
						},
						{
							"type": "null"
						}
					]
				}
			},
			"required": ["connected", "credentials"],
			"additionalProperties": {}
		},
		"bing": {
			"type": "object",
			"properties": {
				"connected": {
					"type": "boolean"
				},
				"credentials": {
					"type": "array",
					"items": {
						"type": "object",
						"properties": {
							"id": {
								"type": "string",
								"format": "uuid",
								"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|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
							},
							"scopes": {
								"type": "string"
							},
							"createdAt": {
								"type": "string"
							},
							"reauthRequiredAt": {
								"anyOf": [
									{
										"type": "string"
									},
									{
										"type": "null"
									}
								]
							}
						},
						"required": ["id", "scopes", "createdAt"],
						"additionalProperties": {}
					}
				},
				"selectedSite": {
					"anyOf": [
						{
							"type": "object",
							"properties": {},
							"additionalProperties": {}
						},
						{
							"type": "null"
						}
					]
				}
			},
			"required": ["connected", "credentials"],
			"additionalProperties": {}
		},
		"lastSyncedAt": {
			"anyOf": [
				{
					"type": "string"
				},
				{
					"type": "null"
				}
			]
		}
	},
	"required": ["site", "workspaceId", "google", "bing"],
	"additionalProperties": false
}

On this page