@oomol-lab/open-connector 1.9.0 → 1.9.1

package/assets/open-connector/catalog/apps/sansan.json

@@ -0,0 +1,4594 @@
+{
+  "service": "sansan",
+  "displayName": "Sansan",
+  "categories": [
+    "Productivity",
+    "Marketing"
+  ],
+  "homepageUrl": "https://jp.sansan.com",
+  "authTypes": [
+    "api_key"
+  ],
+  "auth": [
+    {
+      "type": "api_key",
+      "label": "API Key",
+      "placeholder": "SANSAN_API_KEY",
+      "description": "Create an API key under User name > Settings > API Key, or Administrator settings > External service integration > API. The key inherits its owner's permissions: https://jp-help.sansan.com/hc/ja/articles/206511517."
+    }
+  ],
+  "actions": [
+    {
+      "id": "sansan.check_organization_import",
+      "service": "sansan",
+      "name": "check_organization_import",
+      "description": "Validate user and department import data without applying changes. System administrator only; returns a downloadable CSV report if errors exist.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "users": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "TempId": {
+                  "type": "string",
+                  "maxLength": 256,
+                  "description": "Temporary alphanumeric ID for a new user; blank when editing. Must be unique within the file."
+                },
+                "UserUuid": {
+                  "type": "string",
+                  "description": "Existing user UUID when editing; blank for a new user."
+                },
+                "DepartmentId": {
+                  "type": "string",
+                  "description": "Department IDs separated by semicolons; use tempId:ID for a new department in the same import."
+                },
+                "UserId": {
+                  "type": "string",
+                  "maxLength": 20,
+                  "description": "Immutable user login ID, up to 20 characters; alphanumeric or .-_&."
+                },
+                "UserName": {
+                  "type": "string",
+                  "maxLength": 60,
+                  "description": "User display name, up to 60 characters."
+                },
+                "AlternativeName": {
+                  "type": "string",
+                  "maxLength": 256,
+                  "description": "User name reading."
+                },
+                "Email": {
+                  "type": "string",
+                  "maxLength": 60,
+                  "description": "Unique primary user email within the company."
+                },
+                "SubEmail": {
+                  "type": "string",
+                  "maxLength": 60,
+                  "description": "Secondary user email."
+                },
+                "EffectiveDateFrom": {
+                  "type": "string",
+                  "description": "Usage start date for new users, today or later in RFC3339 format; blank when unchanged during editing."
+                },
+                "SamlNameId": {
+                  "type": "string",
+                  "description": "Unique SAML Name ID within the company."
+                },
+                "Culture": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 2,
+                  "description": "Display language: 0 Japanese, 1 English, 2 Simplified Chinese. Omission serializes as a blank CSV cell."
+                },
+                "MailFormat": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 1,
+                  "description": "Email format: 0 HTML, 1 text. Omission serializes as a blank CSV cell."
+                },
+                "UserType": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 2,
+                  "description": "Role: 0 regular, 1 system administrator, 2 departmental administrator. Omission serializes as a blank CSV cell."
+                },
+                "CanUpdateData": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 1,
+                  "description": "Permission to update all data: 1 granted, 0 denied. Omission serializes as a blank CSV cell."
+                },
+                "DataDownloadPrivilege": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 3,
+                  "description": "Download permission: 0 none, 1 own data, 2 all data, 3 assigned departments. Omission serializes as a blank CSV cell."
+                },
+                "EmailDeliveryPrivilege": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 1,
+                  "description": "Email delivery permission: 1 granted, 0 denied. Omission serializes as a blank CSV cell."
+                },
+                "DealPrivilege": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 2,
+                  "description": "Deal permission: 0 none, 1 regular, 2 administrator. Omission serializes as a blank CSV cell."
+                },
+                "ApiIntegrationPrivilege": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 1,
+                  "description": "API integration permission: 1 granted, 0 denied. Omission serializes as a blank CSV cell."
+                },
+                "UsageStatisticsPrivilege": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 1,
+                  "description": "Usage statistics permission: 1 granted, 0 denied. Omission serializes as a blank CSV cell."
+                },
+                "OrganizationTreeDownloadPrivilege": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 1,
+                  "description": "Organization tree download permission: 1 granted, 0 denied. Omission serializes as a blank CSV cell."
+                },
+                "DeleteFlag": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 1,
+                  "description": "Set to 1 to delete the user. Omission serializes as a blank CSV cell."
+                },
+                "SalesforceIntegrationPrivilege": {
+                  "type": "string",
+                  "description": "Retired field, ignored by Sansan; the CSV column is retained even when omitted."
+                }
+              },
+              "additionalProperties": false,
+              "description": "A user import row using official Sansan CSV columns. Submission requires DepartmentId, UserId, UserName and Email; new users also require TempId and EffectiveDateFrom, while existing users require UserUuid. Blank optional cells preserve unchanged values when editing."
+            },
+            "description": "Structured user rows; Connector builds the official CSV, preserving all columns. Mutually exclusive with usersFileUrl.",
+            "minItems": 1
+          },
+          "departments": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "TempId": {
+                  "type": "string",
+                  "maxLength": 256,
+                  "description": "Temporary alphanumeric ID for a new department; blank when editing."
+                },
+                "DepartmentId": {
+                  "type": "string",
+                  "description": "Existing department ID when editing; blank for a new department."
+                },
+                "DepartmentName": {
+                  "type": "string",
+                  "maxLength": 30,
+                  "description": "Department name."
+                },
+                "DepartmentNamePhonetic": {
+                  "type": "string",
+                  "maxLength": 256,
+                  "description": "Department name reading using lowercase Latin letters, digits, and spaces."
+                },
+                "ParentDepartmentId": {
+                  "type": "string",
+                  "description": "Parent department ID or tempId:ID for a parent created in the same import; blank for no parent."
+                },
+                "Order": {
+                  "type": "integer",
+                  "description": "Department sort order."
+                },
+                "DeleteFlag": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 1,
+                  "description": "Set to 1 to delete the department; it must have no users or child departments."
+                }
+              },
+              "additionalProperties": false,
+              "description": "A department import row using official Sansan CSV columns. Submission requires DepartmentName and either TempId for creation or DepartmentId for editing; the other identifier must be blank or omitted."
+            },
+            "description": "Structured department rows. Mutually exclusive with departmentsFileUrl.",
+            "minItems": 1
+          },
+          "usersFileUrl": {
+            "type": "string",
+            "description": "Public URL of a UTF-8 user CSV with a header row; maximum 20 MiB per source file.",
+            "format": "uri"
+          },
+          "departmentsFileUrl": {
+            "type": "string",
+            "description": "Public URL of a UTF-8 department CSV with a header row; maximum 20 MiB per source file.",
+            "format": "uri"
+          },
+          "delimiter": {
+            "type": "string",
+            "enum": [
+              "comma",
+              "semicolon",
+              "tab",
+              "space"
+            ],
+            "description": "CSV delimiter; defaults to comma."
+          }
+        },
+        "additionalProperties": false,
+        "description": "Users and/or departments to check or import. System administrator only.",
+        "anyOf": [
+          {
+            "required": [
+              "users"
+            ]
+          },
+          {
+            "required": [
+              "departments"
+            ]
+          },
+          {
+            "required": [
+              "usersFileUrl"
+            ]
+          },
+          {
+            "required": [
+              "departmentsFileUrl"
+            ]
+          }
+        ],
+        "allOf": [
+          {
+            "not": {
+              "required": [
+                "users",
+                "usersFileUrl"
+              ]
+            }
+          },
+          {
+            "not": {
+              "required": [
+                "departments",
+                "departmentsFileUrl"
+              ]
+            }
+          }
+        ]
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "valid": {
+            "type": "boolean",
+            "description": "Whether Sansan returned an empty validation response, indicating valid data."
+          },
+          "report": {
+            "anyOf": [
+              {
+                "type": "object",
+                "properties": {
+                  "fileId": {
+                    "type": "string",
+                    "description": "The stored transit file identifier."
+                  },
+                  "downloadUrl": {
+                    "type": "string",
+                    "description": "The transit file download URL."
+                  },
+                  "name": {
+                    "type": "string",
+                    "description": "The file name."
+                  },
+                  "mimeType": {
+                    "type": "string",
+                    "description": "The file media type."
+                  },
+                  "sizeBytes": {
+                    "type": "integer",
+                    "description": "The file size in bytes."
+                  }
+                },
+                "additionalProperties": false,
+                "required": [
+                  "fileId",
+                  "downloadUrl",
+                  "name",
+                  "mimeType",
+                  "sizeBytes"
+                ],
+                "description": "A downloaded file in local transit storage."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "A downloaded file in local transit storage."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "valid",
+          "report"
+        ],
+        "description": "Organization import validation result."
+      }
+    },
+    {
+      "id": "sansan.create_access_control_pattern",
+      "service": "sansan",
+      "name": "create_access_control_pattern",
+      "description": "Create an access control pattern with department access rules. System administrator only.",
+      "operationType": "write",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "aclPatternName": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Access control pattern name."
+          },
+          "description": {
+            "type": "string",
+            "description": "Access control pattern description."
+          },
+          "details": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "objectDepartmentId": {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "The department whose data this rule covers."
+                },
+                "accessibleFieldsSettingsName": {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "The upstream accessible-fields setting name, such as ALL. Use values configured in Sansan; no complete enum is published."
+                }
+              },
+              "additionalProperties": true,
+              "required": [
+                "objectDepartmentId",
+                "accessibleFieldsSettingsName"
+              ],
+              "description": "Access rule for a target department; additional provider-defined fields are accepted."
+            },
+            "description": "Department access rules."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "aclPatternName",
+          "details"
+        ],
+        "description": "New access control pattern."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The access control pattern ID."
+          }
+        },
+        "additionalProperties": true,
+        "required": [
+          "id"
+        ],
+        "description": "Created access control pattern."
+      }
+    },
+    {
+      "id": "sansan.create_business_card",
+      "service": "sansan",
+      "name": "create_business_card",
+      "description": "Create a Sansan business card, optionally for another user through the administrator import API.",
+      "operationType": "write",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "ownerUserId": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Optional record owner user ID. When provided, use the system-administrator import API; the user must belong to the same company and contract. Omit to create for the connected user."
+          },
+          "lastName": {
+            "anyOf": [
+              {
+                "type": "string",
+                "maxLength": 250,
+                "description": "Last name."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Last name."
+          },
+          "firstName": {
+            "anyOf": [
+              {
+                "type": "string",
+                "maxLength": 250,
+                "description": "First name."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "First name."
+          },
+          "lastNameReading": {
+            "anyOf": [
+              {
+                "type": "string",
+                "maxLength": 250,
+                "description": "Last name reading in kana; do not use kanji, hiragana, or full-width alphanumeric characters."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Last name reading in kana; do not use kanji, hiragana, or full-width alphanumeric characters."
+          },
+          "firstNameReading": {
+            "anyOf": [
+              {
+                "type": "string",
+                "maxLength": 250,
+                "description": "First name reading in kana; do not use kanji, hiragana, or full-width alphanumeric characters."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "First name reading in kana; do not use kanji, hiragana, or full-width alphanumeric characters."
+          },
+          "departmentName": {
+            "anyOf": [
+              {
+                "type": "string",
+                "maxLength": 250,
+                "description": "Department name."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Department name."
+          },
+          "title": {
+            "anyOf": [
+              {
+                "type": "string",
+                "maxLength": 250,
+                "description": "Job title."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Job title."
+          },
+          "companyName": {
+            "anyOf": [
+              {
+                "type": "string",
+                "maxLength": 250,
+                "description": "Company name."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Company name."
+          },
+          "prefecture": {
+            "anyOf": [
+              {
+                "type": "string",
+                "maxLength": 250,
+                "description": "Prefecture or state."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Prefecture or state."
+          },
+          "city": {
+            "anyOf": [
+              {
+                "type": "string",
+                "maxLength": 250,
+                "description": "City."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "City."
+          },
+          "street": {
+            "anyOf": [
+              {
+                "type": "string",
+                "maxLength": 250,
+                "description": "Street address."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Street address."
+          },
+          "building": {
+            "anyOf": [
+              {
+                "type": "string",
+                "maxLength": 250,
+                "description": "Building."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Building."
+          },
+          "email": {
+            "anyOf": [
+              {
+                "type": "string",
+                "maxLength": 250,
+                "description": "Email address."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Email address."
+          },
+          "mobile": {
+            "anyOf": [
+              {
+                "type": "string",
+                "maxLength": 30,
+                "description": "Mobile number using digits, plus, and hyphen."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Mobile number using digits, plus, and hyphen."
+          },
+          "tel": {
+            "anyOf": [
+              {
+                "type": "string",
+                "maxLength": 30,
+                "description": "Telephone number using digits, plus, and hyphen."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Telephone number using digits, plus, and hyphen."
+          },
+          "secondTel": {
+            "anyOf": [
+              {
+                "type": "string",
+                "maxLength": 30,
+                "description": "Second telephone number using digits, plus, and hyphen."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Second telephone number using digits, plus, and hyphen."
+          },
+          "fax": {
+            "anyOf": [
+              {
+                "type": "string",
+                "maxLength": 30,
+                "description": "Fax number using digits, plus, and hyphen."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Fax number using digits, plus, and hyphen."
+          },
+          "url": {
+            "anyOf": [
+              {
+                "type": "string",
+                "maxLength": 250,
+                "description": "Website URL."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Website URL."
+          },
+          "memo": {
+            "anyOf": [
+              {
+                "type": "string",
+                "maxLength": 2000,
+                "description": "Memo."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Memo."
+          },
+          "exchangeDate": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "Business card exchange date, YYYY-MM-DD.",
+                "format": "date"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Business card exchange date, YYYY-MM-DD."
+          },
+          "countryCode": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "ISO 3166-1 alpha-2 country code or AUTO to infer the country from contact information."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "ISO 3166-1 alpha-2 country code or AUTO to infer the country from contact information."
+          },
+          "postalCode": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "Postal code: alphanumeric, hyphens and spaces; at most ten characters excluding hyphens and spaces."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Postal code: alphanumeric, hyphens and spaces; at most ten characters excluding hyphens and spaces."
+          },
+          "tagIds": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1,
+              "description": "An existing tag ID."
+            },
+            "description": "Existing tag IDs to attach, at most fifteen.",
+            "maxItems": 15
+          },
+          "sharingPermissions": {
+            "anyOf": [
+              {
+                "type": "object",
+                "properties": {
+                  "companyInformation": {
+                    "anyOf": [
+                      {
+                        "type": "boolean",
+                        "description": "Whether to share company information."
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ],
+                    "description": "Whether to share company information."
+                  },
+                  "name": {
+                    "anyOf": [
+                      {
+                        "type": "boolean",
+                        "description": "Whether to share the name."
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ],
+                    "description": "Whether to share the name."
+                  },
+                  "exchangeDate": {
+                    "anyOf": [
+                      {
+                        "type": "boolean",
+                        "description": "Whether to share the exchange date."
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ],
+                    "description": "Whether to share the exchange date."
+                  },
+                  "contact": {
+                    "anyOf": [
+                      {
+                        "type": "boolean",
+                        "description": "Whether to share contact details."
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ],
+                    "description": "Whether to share contact details."
+                  },
+                  "mobile": {
+                    "anyOf": [
+                      {
+                        "type": "boolean",
+                        "description": "Whether to share the mobile number."
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ],
+                    "description": "Whether to share the mobile number."
+                  },
+                  "email": {
+                    "anyOf": [
+                      {
+                        "type": "boolean",
+                        "description": "Whether to share the email address."
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ],
+                    "description": "Whether to share the email address."
+                  },
+                  "memo": {
+                    "anyOf": [
+                      {
+                        "type": "boolean",
+                        "description": "Whether to share the memo."
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ],
+                    "description": "Whether to share the memo."
+                  },
+                  "others": {
+                    "anyOf": [
+                      {
+                        "type": "boolean",
+                        "description": "Whether to share other information."
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ],
+                    "description": "Whether to share other information."
+                  }
+                },
+                "additionalProperties": false,
+                "description": "Per-field visibility settings."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Per-field visibility settings."
+          }
+        },
+        "additionalProperties": false,
+        "description": "Business card fields. At least one non-empty companyName, firstName, or lastName is required.",
+        "anyOf": [
+          {
+            "required": [
+              "companyName"
+            ],
+            "properties": {
+              "companyName": {
+                "type": "string",
+                "minLength": 1
+              }
+            }
+          },
+          {
+            "required": [
+              "firstName"
+            ],
+            "properties": {
+              "firstName": {
+                "type": "string",
+                "minLength": 1
+              }
+            }
+          },
+          {
+            "required": [
+              "lastName"
+            ],
+            "properties": {
+              "lastName": {
+                "type": "string",
+                "minLength": 1
+              }
+            }
+          }
+        ]
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The business card ID."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The business card ID."
+          },
+          "companyId": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The company ID."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The company ID."
+          },
+          "personId": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The person ID."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The person ID."
+          },
+          "firstName": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The first name."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The first name."
+          },
+          "lastName": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The last name."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The last name."
+          },
+          "companyName": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The company name."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The company name."
+          },
+          "departmentName": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The department name."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The department name."
+          },
+          "title": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The job title."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The job title."
+          },
+          "email": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The email address."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The email address."
+          },
+          "tel": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The telephone number."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The telephone number."
+          },
+          "mobile": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The mobile phone number."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The mobile phone number."
+          },
+          "exchangeDate": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The business card exchange date."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The business card exchange date."
+          },
+          "registeredTime": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The registration timestamp."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The registration timestamp."
+          },
+          "updatedTime": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The last update timestamp."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The last update timestamp."
+          },
+          "entryStatus": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The digitization status."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The digitization status."
+          },
+          "owner": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string",
+                "description": "The owner user ID."
+              },
+              "name": {
+                "type": "string",
+                "description": "The owner name."
+              },
+              "email": {
+                "type": "string",
+                "description": "The owner email address."
+              }
+            },
+            "additionalProperties": true,
+            "description": "The business card or tag owner."
+          },
+          "tags": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "id": {
+                  "type": "string",
+                  "description": "The tag ID."
+                },
+                "name": {
+                  "type": "string",
+                  "description": "The tag name."
+                },
+                "type": {
+                  "type": "string",
+                  "description": "The tag visibility: private, public, or shared."
+                },
+                "owner": {
+                  "type": "object",
+                  "properties": {
+                    "id": {
+                      "type": "string",
+                      "description": "The owner user ID."
+                    },
+                    "name": {
+                      "type": "string",
+                      "description": "The owner name."
+                    },
+                    "email": {
+                      "type": "string",
+                      "description": "The owner email address."
+                    }
+                  },
+                  "additionalProperties": true,
+                  "description": "The business card or tag owner."
+                }
+              },
+              "additionalProperties": true,
+              "description": "A Sansan tag, with additional upstream fields preserved."
+            },
+            "description": "Tags attached to the business card when requested."
+          }
+        },
+        "additionalProperties": true,
+        "description": "A business card with contact details; additional Sansan fields are preserved."
+      }
+    },
+    {
+      "id": "sansan.create_contact_report",
+      "service": "sansan",
+      "name": "create_contact_report",
+      "description": "Create a Sansan contact report. External attendee details also create new business cards; optionally import for another owner as an administrator.",
+      "operationType": "write",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "ownerUserId": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Optional record owner user ID. When provided, use the system-administrator import API; the user must belong to the same company and contract. Omit to create for the connected user."
+          },
+          "startTime": {
+            "type": "string",
+            "description": "Start timestamp with timezone; seconds must be 00.",
+            "format": "date-time"
+          },
+          "endTime": {
+            "type": "string",
+            "description": "End timestamp with timezone; seconds must be 00.",
+            "format": "date-time"
+          },
+          "externalAttendees": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "companyName": {
+                  "type": "string",
+                  "maxLength": 250,
+                  "description": "Company name."
+                },
+                "lastName": {
+                  "type": "string",
+                  "maxLength": 250,
+                  "description": "Last name."
+                },
+                "firstName": {
+                  "type": "string",
+                  "maxLength": 250,
+                  "description": "First name."
+                },
+                "email": {
+                  "type": "string",
+                  "maxLength": 250,
+                  "description": "Email address."
+                }
+              },
+              "additionalProperties": false,
+              "description": "An external attendee. Sansan creates a new business card from these details.",
+              "anyOf": [
+                {
+                  "required": [
+                    "companyName"
+                  ],
+                  "properties": {
+                    "companyName": {
+                      "minLength": 1
+                    }
+                  }
+                },
+                {
+                  "required": [
+                    "lastName"
+                  ],
+                  "properties": {
+                    "lastName": {
+                      "minLength": 1
+                    }
+                  }
+                },
+                {
+                  "required": [
+                    "firstName"
+                  ],
+                  "properties": {
+                    "firstName": {
+                      "minLength": 1
+                    }
+                  }
+                }
+              ]
+            },
+            "description": "External attendees whose details create new business cards."
+          },
+          "internalAttendeeUserIds": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1,
+              "description": "An internal user ID."
+            },
+            "description": "Internal attendee user IDs; omission defaults to the report owner."
+          },
+          "type": {
+            "type": "string",
+            "enum": [
+              "Meeting",
+              "Visit",
+              "MeetingAtOffice",
+              "Call",
+              "OutboundCall",
+              "InboundCall",
+              "Email",
+              "SentEmail",
+              "ReceivedEmail",
+              "OnlineMeeting"
+            ],
+            "description": "The contact interaction type."
+          },
+          "title": {
+            "type": "string",
+            "description": "Contact report title."
+          },
+          "location": {
+            "type": "string",
+            "description": "Contact location."
+          },
+          "memo": {
+            "type": "string",
+            "description": "Contact report memo."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "startTime",
+          "endTime",
+          "externalAttendees",
+          "type"
+        ],
+        "description": "Contact report details."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": "Contact report ID."
+          },
+          "registeredTime": {
+            "type": "string",
+            "description": "Contact report registration timestamp."
+          },
+          "updatedTime": {
+            "type": "string",
+            "description": "Contact report update timestamp."
+          },
+          "startDate": {
+            "type": "string",
+            "description": "Interaction start date."
+          },
+          "endDate": {
+            "type": "string",
+            "description": "Interaction end date."
+          },
+          "startTime": {
+            "type": "string",
+            "description": "Interaction start timestamp."
+          },
+          "endTime": {
+            "type": "string",
+            "description": "Interaction end timestamp."
+          },
+          "type": {
+            "type": "string",
+            "description": "Recorded interaction type."
+          },
+          "title": {
+            "type": "string",
+            "description": "Contact report title."
+          },
+          "location": {
+            "type": "string",
+            "description": "Contact location."
+          },
+          "memo": {
+            "type": "string",
+            "description": "Contact report memo."
+          },
+          "owner": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string",
+                "description": "The owner user ID."
+              },
+              "name": {
+                "type": "string",
+                "description": "The owner name."
+              },
+              "email": {
+                "type": "string",
+                "description": "The owner email address."
+              }
+            },
+            "additionalProperties": true,
+            "description": "The business card or tag owner."
+          },
+          "externalAttendees": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "additionalProperties": true,
+              "description": "An external participant with provider-defined contact fields."
+            },
+            "description": "External attendees and their business card and person IDs."
+          },
+          "internalAttendees": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "additionalProperties": true,
+              "description": "An internal participant with provider-defined user fields."
+            },
+            "description": "Internal attendees and their user details."
+          },
+          "categories": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "additionalProperties": true,
+              "description": "A category name and value."
+            },
+            "description": "Categories assigned to the contact report."
+          }
+        },
+        "additionalProperties": true,
+        "description": "A contact report with meeting or communication details and additional upstream fields."
+      }
+    },
+    {
+      "id": "sansan.delete_access_control_pattern",
+      "service": "sansan",
+      "name": "delete_access_control_pattern",
+      "description": "Delete an access control pattern. System administrator only; Sansan may reject a pattern still in use.",
+      "operationType": "destructive",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "patternId": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The access control pattern ID."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "patternId"
+        ],
+        "description": "Access control pattern to delete."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "success": {
+            "type": "boolean",
+            "description": "Whether the request succeeded."
+          },
+          "data": {
+            "anyOf": [
+              {
+                "type": "object",
+                "additionalProperties": true,
+                "description": "Any JSON payload returned by Sansan."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Any JSON payload returned by Sansan."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "success",
+          "data"
+        ],
+        "description": "Successful administration change."
+      }
+    },
+    {
+      "id": "sansan.export_organization_departments",
+      "service": "sansan",
+      "name": "export_organization_departments",
+      "description": "Export Sansan organization departments as a CSV download. System administrator only.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "delimiter": {
+            "type": "string",
+            "enum": [
+              "comma",
+              "semicolon",
+              "tab",
+              "space"
+            ],
+            "description": "CSV delimiter; defaults to comma."
+          }
+        },
+        "additionalProperties": false,
+        "description": "Department export options."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "fileId": {
+            "type": "string",
+            "description": "The stored transit file identifier."
+          },
+          "downloadUrl": {
+            "type": "string",
+            "description": "The transit file download URL."
+          },
+          "name": {
+            "type": "string",
+            "description": "The file name."
+          },
+          "mimeType": {
+            "type": "string",
+            "description": "The file media type."
+          },
+          "sizeBytes": {
+            "type": "integer",
+            "description": "The file size in bytes."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "fileId",
+          "downloadUrl",
+          "name",
+          "mimeType",
+          "sizeBytes"
+        ],
+        "description": "A downloaded file in local transit storage."
+      }
+    },
+    {
+      "id": "sansan.export_organization_users",
+      "service": "sansan",
+      "name": "export_organization_users",
+      "description": "Export Sansan organization users as a CSV download. System administrator only.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "delimiter": {
+            "type": "string",
+            "enum": [
+              "comma",
+              "semicolon",
+              "tab",
+              "space"
+            ],
+            "description": "CSV delimiter; defaults to comma."
+          }
+        },
+        "additionalProperties": false,
+        "description": "User export options."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "fileId": {
+            "type": "string",
+            "description": "The stored transit file identifier."
+          },
+          "downloadUrl": {
+            "type": "string",
+            "description": "The transit file download URL."
+          },
+          "name": {
+            "type": "string",
+            "description": "The file name."
+          },
+          "mimeType": {
+            "type": "string",
+            "description": "The file media type."
+          },
+          "sizeBytes": {
+            "type": "integer",
+            "description": "The file size in bytes."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "fileId",
+          "downloadUrl",
+          "name",
+          "mimeType",
+          "sizeBytes"
+        ],
+        "description": "A downloaded file in local transit storage."
+      }
+    },
+    {
+      "id": "sansan.get_business_card",
+      "service": "sansan",
+      "name": "get_business_card",
+      "description": "Get a business card by ID. Sansan may return the latest merged card with a different ID.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "businessCardId": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The Sansan business card ID."
+          },
+          "includeTags": {
+            "type": "boolean",
+            "description": "Include attached tags and treat tag changes as business card updates."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "businessCardId"
+        ],
+        "description": "Business card lookup."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The business card ID."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The business card ID."
+          },
+          "companyId": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The company ID."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The company ID."
+          },
+          "personId": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The person ID."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The person ID."
+          },
+          "firstName": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The first name."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The first name."
+          },
+          "lastName": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The last name."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The last name."
+          },
+          "companyName": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The company name."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The company name."
+          },
+          "departmentName": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The department name."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The department name."
+          },
+          "title": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The job title."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The job title."
+          },
+          "email": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The email address."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The email address."
+          },
+          "tel": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The telephone number."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The telephone number."
+          },
+          "mobile": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The mobile phone number."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The mobile phone number."
+          },
+          "exchangeDate": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The business card exchange date."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The business card exchange date."
+          },
+          "registeredTime": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The registration timestamp."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The registration timestamp."
+          },
+          "updatedTime": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The last update timestamp."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The last update timestamp."
+          },
+          "entryStatus": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The digitization status."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The digitization status."
+          },
+          "owner": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string",
+                "description": "The owner user ID."
+              },
+              "name": {
+                "type": "string",
+                "description": "The owner name."
+              },
+              "email": {
+                "type": "string",
+                "description": "The owner email address."
+              }
+            },
+            "additionalProperties": true,
+            "description": "The business card or tag owner."
+          },
+          "tags": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "id": {
+                  "type": "string",
+                  "description": "The tag ID."
+                },
+                "name": {
+                  "type": "string",
+                  "description": "The tag name."
+                },
+                "type": {
+                  "type": "string",
+                  "description": "The tag visibility: private, public, or shared."
+                },
+                "owner": {
+                  "type": "object",
+                  "properties": {
+                    "id": {
+                      "type": "string",
+                      "description": "The owner user ID."
+                    },
+                    "name": {
+                      "type": "string",
+                      "description": "The owner name."
+                    },
+                    "email": {
+                      "type": "string",
+                      "description": "The owner email address."
+                    }
+                  },
+                  "additionalProperties": true,
+                  "description": "The business card or tag owner."
+                }
+              },
+              "additionalProperties": true,
+              "description": "A Sansan tag, with additional upstream fields preserved."
+            },
+            "description": "Tags attached to the business card when requested."
+          }
+        },
+        "additionalProperties": true,
+        "description": "A business card with contact details; additional Sansan fields are preserved."
+      }
+    },
+    {
+      "id": "sansan.get_business_card_image",
+      "service": "sansan",
+      "name": "get_business_card_image",
+      "description": "Download the front or back of a Sansan business card as a JPEG file URL.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "businessCardId": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The Sansan business card ID."
+          },
+          "side": {
+            "type": "string",
+            "enum": [
+              "front",
+              "back"
+            ],
+            "description": "The card side; defaults to front."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "businessCardId"
+        ],
+        "description": "Business card image selection."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "fileId": {
+            "type": "string",
+            "description": "The stored transit file identifier."
+          },
+          "downloadUrl": {
+            "type": "string",
+            "description": "The transit file download URL."
+          },
+          "name": {
+            "type": "string",
+            "description": "The file name."
+          },
+          "mimeType": {
+            "type": "string",
+            "description": "The file media type."
+          },
+          "sizeBytes": {
+            "type": "integer",
+            "description": "The file size in bytes."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "fileId",
+          "downloadUrl",
+          "name",
+          "mimeType",
+          "sizeBytes"
+        ],
+        "description": "A downloaded file in local transit storage."
+      }
+    },
+    {
+      "id": "sansan.get_current_user",
+      "service": "sansan",
+      "name": "get_current_user",
+      "description": "Get the Sansan user and permissions associated with the connected API key.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {},
+        "additionalProperties": false,
+        "description": "No input is required."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": "The user ID."
+          },
+          "name": {
+            "type": "string",
+            "description": "The user name."
+          },
+          "userType": {
+            "type": "string",
+            "description": "The user role in Sansan."
+          },
+          "canUpdateData": {
+            "type": "boolean",
+            "description": "Whether the user can update all data."
+          },
+          "departments": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "name": {
+                  "type": "string",
+                  "description": "The department name."
+                }
+              },
+              "additionalProperties": true,
+              "description": "A user department."
+            },
+            "description": "Departments the user belongs to."
+          }
+        },
+        "additionalProperties": true,
+        "description": "The Sansan user associated with the API key."
+      }
+    },
+    {
+      "id": "sansan.get_default_email_client",
+      "service": "sansan",
+      "name": "get_default_email_client",
+      "description": "Get the default email client settings for new users. System administrator only.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {},
+        "additionalProperties": false,
+        "description": "No input is required."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "settings": {
+            "anyOf": [
+              {
+                "type": "object",
+                "properties": {
+                  "emailClient": {
+                    "type": "string",
+                    "enum": [
+                      "clientSoftware",
+                      "gmail",
+                      "office365"
+                    ],
+                    "description": "Default email client for newly added users."
+                  },
+                  "encoding": {
+                    "type": "string",
+                    "enum": [
+                      "sjis",
+                      "utf8",
+                      "iso2022jp"
+                    ],
+                    "description": "Required only for clientSoftware."
+                  }
+                },
+                "additionalProperties": true,
+                "description": "Email client configuration."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Email client configuration."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "settings"
+        ],
+        "description": "Organization default email client; null when not configured."
+      }
+    },
+    {
+      "id": "sansan.get_department_access_control",
+      "service": "sansan",
+      "name": "get_department_access_control",
+      "description": "Get the access control pattern assigned to a department. System administrator only.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "departmentId": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The department ID."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "departmentId"
+        ],
+        "description": "Department selection."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "departmentId": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The department ID."
+          },
+          "accessControlPattern": {
+            "type": "object",
+            "properties": {
+              "aclPatternId": {
+                "type": "string",
+                "minLength": 1,
+                "description": "The access control pattern ID."
+              },
+              "aclPatternName": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Access control pattern name."
+              },
+              "description": {
+                "type": "string",
+                "description": "Access control pattern description."
+              },
+              "details": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "objectDepartmentId": {
+                      "type": "string",
+                      "minLength": 1,
+                      "description": "The department whose data this rule covers."
+                    },
+                    "accessibleFieldsSettingsName": {
+                      "type": "string",
+                      "minLength": 1,
+                      "description": "The upstream accessible-fields setting name, such as ALL. Use values configured in Sansan; no complete enum is published."
+                    }
+                  },
+                  "additionalProperties": true,
+                  "required": [
+                    "objectDepartmentId",
+                    "accessibleFieldsSettingsName"
+                  ],
+                  "description": "Access rule for a target department; additional provider-defined fields are accepted."
+                },
+                "description": "Department access rules."
+              },
+              "isInUse": {
+                "type": "boolean",
+                "description": "Whether this pattern is in use."
+              }
+            },
+            "additionalProperties": true,
+            "description": "A Sansan access control pattern, including upstream-defined fields."
+          }
+        },
+        "additionalProperties": true,
+        "description": "Department access control assignment."
+      }
+    },
+    {
+      "id": "sansan.get_organization_import_result",
+      "service": "sansan",
+      "name": "get_organization_import_result",
+      "description": "Check an organization import and return its result CSV when completed or failed. System administrator only. The report includes created IDs and row-level errors.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "importId": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The import ID returned when the job was submitted."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "importId"
+        ],
+        "description": "Organization import job identifier."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "importId": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The import ID."
+          },
+          "importStatus": {
+            "type": "integer",
+            "description": "Upstream import status: 0 queued, 1 running, 2 completed, 9 error."
+          },
+          "status": {
+            "type": "string",
+            "enum": [
+              "queued",
+              "running",
+              "completed",
+              "failed"
+            ],
+            "description": "Normalized import status."
+          },
+          "report": {
+            "anyOf": [
+              {
+                "type": "object",
+                "properties": {
+                  "fileId": {
+                    "type": "string",
+                    "description": "The stored transit file identifier."
+                  },
+                  "downloadUrl": {
+                    "type": "string",
+                    "description": "The transit file download URL."
+                  },
+                  "name": {
+                    "type": "string",
+                    "description": "The file name."
+                  },
+                  "mimeType": {
+                    "type": "string",
+                    "description": "The file media type."
+                  },
+                  "sizeBytes": {
+                    "type": "integer",
+                    "description": "The file size in bytes."
+                  }
+                },
+                "additionalProperties": false,
+                "required": [
+                  "fileId",
+                  "downloadUrl",
+                  "name",
+                  "mimeType",
+                  "sizeBytes"
+                ],
+                "description": "A downloaded file in local transit storage."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "A downloaded file in local transit storage."
+          }
+        },
+        "additionalProperties": true,
+        "required": [
+          "importId",
+          "importStatus",
+          "status",
+          "report"
+        ],
+        "description": "Organization import state and result report."
+      },
+      "asyncLifecycle": {
+        "startActionId": "sansan.submit_organization_import",
+        "statusActionId": "sansan.get_organization_import_result"
+      }
+    },
+    {
+      "id": "sansan.get_organization_import_status",
+      "service": "sansan",
+      "name": "get_organization_import_status",
+      "description": "Get the current organization import status. System administrator only.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "importId": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The import ID returned when the job was submitted."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "importId"
+        ],
+        "description": "Organization import job identifier."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "importStatus": {
+            "type": "integer",
+            "description": "Upstream import status: 0 queued, 1 running, 2 completed, 9 error."
+          },
+          "status": {
+            "type": "string",
+            "enum": [
+              "queued",
+              "running",
+              "completed",
+              "failed"
+            ],
+            "description": "Normalized import status."
+          }
+        },
+        "additionalProperties": true,
+        "required": [
+          "importStatus",
+          "status"
+        ],
+        "description": "Organization import status."
+      }
+    },
+    {
+      "id": "sansan.get_person",
+      "service": "sansan",
+      "name": "get_person",
+      "description": "Get the latest business card for a Sansan person, optionally including tags.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "personId": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The Sansan person ID."
+          },
+          "includeTags": {
+            "type": "boolean",
+            "description": "Include attached tags and treat tag changes as business card updates."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "personId"
+        ],
+        "description": "Person lookup."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The business card ID."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The business card ID."
+          },
+          "companyId": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The company ID."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The company ID."
+          },
+          "personId": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The person ID."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The person ID."
+          },
+          "firstName": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The first name."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The first name."
+          },
+          "lastName": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The last name."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The last name."
+          },
+          "companyName": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The company name."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The company name."
+          },
+          "departmentName": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The department name."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The department name."
+          },
+          "title": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The job title."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The job title."
+          },
+          "email": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The email address."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The email address."
+          },
+          "tel": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The telephone number."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The telephone number."
+          },
+          "mobile": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The mobile phone number."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The mobile phone number."
+          },
+          "exchangeDate": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The business card exchange date."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The business card exchange date."
+          },
+          "registeredTime": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The registration timestamp."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The registration timestamp."
+          },
+          "updatedTime": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The last update timestamp."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The last update timestamp."
+          },
+          "entryStatus": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The digitization status."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The digitization status."
+          },
+          "owner": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string",
+                "description": "The owner user ID."
+              },
+              "name": {
+                "type": "string",
+                "description": "The owner name."
+              },
+              "email": {
+                "type": "string",
+                "description": "The owner email address."
+              }
+            },
+            "additionalProperties": true,
+            "description": "The business card or tag owner."
+          },
+          "tags": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "id": {
+                  "type": "string",
+                  "description": "The tag ID."
+                },
+                "name": {
+                  "type": "string",
+                  "description": "The tag name."
+                },
+                "type": {
+                  "type": "string",
+                  "description": "The tag visibility: private, public, or shared."
+                },
+                "owner": {
+                  "type": "object",
+                  "properties": {
+                    "id": {
+                      "type": "string",
+                      "description": "The owner user ID."
+                    },
+                    "name": {
+                      "type": "string",
+                      "description": "The owner name."
+                    },
+                    "email": {
+                      "type": "string",
+                      "description": "The owner email address."
+                    }
+                  },
+                  "additionalProperties": true,
+                  "description": "The business card or tag owner."
+                }
+              },
+              "additionalProperties": true,
+              "description": "A Sansan tag, with additional upstream fields preserved."
+            },
+            "description": "Tags attached to the business card when requested."
+          }
+        },
+        "additionalProperties": true,
+        "description": "A business card with contact details; additional Sansan fields are preserved."
+      }
+    },
+    {
+      "id": "sansan.list_access_control_patterns",
+      "service": "sansan",
+      "name": "list_access_control_patterns",
+      "description": "List access control patterns, optionally filtering by a name substring. System administrator only.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "nextPageToken": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Continue with the next page token; original filters are inherited."
+          },
+          "name": {
+            "type": "string",
+            "description": "Pattern name substring."
+          }
+        },
+        "additionalProperties": false,
+        "description": "Access control pattern search."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "data": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "aclPatternId": {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "The access control pattern ID."
+                },
+                "aclPatternName": {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "Access control pattern name."
+                },
+                "description": {
+                  "type": "string",
+                  "description": "Access control pattern description."
+                },
+                "details": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "objectDepartmentId": {
+                        "type": "string",
+                        "minLength": 1,
+                        "description": "The department whose data this rule covers."
+                      },
+                      "accessibleFieldsSettingsName": {
+                        "type": "string",
+                        "minLength": 1,
+                        "description": "The upstream accessible-fields setting name, such as ALL. Use values configured in Sansan; no complete enum is published."
+                      }
+                    },
+                    "additionalProperties": true,
+                    "required": [
+                      "objectDepartmentId",
+                      "accessibleFieldsSettingsName"
+                    ],
+                    "description": "Access rule for a target department; additional provider-defined fields are accepted."
+                  },
+                  "description": "Department access rules."
+                },
+                "isInUse": {
+                  "type": "boolean",
+                  "description": "Whether this pattern is in use."
+                }
+              },
+              "additionalProperties": true,
+              "description": "A Sansan access control pattern, including upstream-defined fields."
+            },
+            "description": "Records in this page."
+          },
+          "hasMore": {
+            "type": "boolean",
+            "description": "Whether another page is available."
+          },
+          "nextPageToken": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The next page token, or null."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The next page token, or null."
+          }
+        },
+        "additionalProperties": true,
+        "required": [
+          "data",
+          "hasMore",
+          "nextPageToken"
+        ],
+        "description": "A page of administration records."
+      }
+    },
+    {
+      "id": "sansan.list_business_card_tags",
+      "service": "sansan",
+      "name": "list_business_card_tags",
+      "description": "List tags attached to a Sansan business card.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "businessCardId": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The Sansan business card ID."
+          },
+          "nextPageToken": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Continue a previous query using its nextPageToken; original query parameters are inherited."
+          },
+          "limit": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 300,
+            "description": "Maximum records per page, from 1 to 300; defaults to 100."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "businessCardId"
+        ],
+        "description": "Business card tag query."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "data": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "id": {
+                  "type": "string",
+                  "description": "The tag ID."
+                },
+                "name": {
+                  "type": "string",
+                  "description": "The tag name."
+                },
+                "type": {
+                  "type": "string",
+                  "description": "The tag visibility: private, public, or shared."
+                },
+                "owner": {
+                  "type": "object",
+                  "properties": {
+                    "id": {
+                      "type": "string",
+                      "description": "The owner user ID."
+                    },
+                    "name": {
+                      "type": "string",
+                      "description": "The owner name."
+                    },
+                    "email": {
+                      "type": "string",
+                      "description": "The owner email address."
+                    }
+                  },
+                  "additionalProperties": true,
+                  "description": "The business card or tag owner."
+                }
+              },
+              "additionalProperties": true,
+              "description": "A Sansan tag, with additional upstream fields preserved."
+            },
+            "description": "Records in this page."
+          },
+          "hasMore": {
+            "type": "boolean",
+            "description": "Whether another page is available."
+          },
+          "nextPageToken": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The next page token, or null when absent. Tokens expire six hours after the first request."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The next page token, or null when absent. Tokens expire six hours after the first request."
+          }
+        },
+        "additionalProperties": true,
+        "required": [
+          "data",
+          "hasMore",
+          "nextPageToken"
+        ],
+        "description": "One page of Sansan records."
+      }
+    },
+    {
+      "id": "sansan.list_business_cards",
+      "service": "sansan",
+      "name": "list_business_cards",
+      "description": "List business cards updated within a time interval, with optional historical cards and tags. Use nextPageToken to continue.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "nextPageToken": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Continue a previous query using its nextPageToken; original query parameters are inherited."
+          },
+          "limit": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 300,
+            "description": "Maximum records per page, from 1 to 300; defaults to 100."
+          },
+          "range": {
+            "type": "string",
+            "enum": [
+              "me",
+              "all"
+            ],
+            "description": "Record ownership scope: me or all accessible records; defaults to me."
+          },
+          "includeTags": {
+            "type": "boolean",
+            "description": "Include attached tags and treat tag changes as business card updates."
+          },
+          "includePastBizCards": {
+            "type": "boolean",
+            "description": "Include older business cards for merged persons; defaults to false."
+          },
+          "entryStatus": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "enum": [
+                "processing",
+                "completed",
+                "unreadable"
+              ],
+              "description": "A business card digitization status."
+            },
+            "description": "Digitization statuses to include; defaults to completed."
+          },
+          "orderBy": {
+            "type": "string",
+            "enum": [
+              "registeredAt",
+              "completedAt",
+              "updatedAt"
+            ],
+            "description": "Sort field; defaults to updatedAt for listing and registeredAt for searching."
+          },
+          "orderDirection": {
+            "type": "string",
+            "enum": [
+              "asc",
+              "desc"
+            ],
+            "description": "Sort direction; defaults to asc for listing and desc for searching."
+          },
+          "updatedFrom": {
+            "type": "string",
+            "description": "Start of the update interval as an ISO 8601 timestamp with timezone. Required on the first page.",
+            "format": "date-time"
+          },
+          "updatedTo": {
+            "type": "string",
+            "description": "End of the update interval as an ISO 8601 timestamp with timezone. Required on the first page.",
+            "format": "date-time"
+          }
+        },
+        "additionalProperties": false,
+        "description": "Business card update query.",
+        "anyOf": [
+          {
+            "required": [
+              "nextPageToken"
+            ]
+          },
+          {
+            "required": [
+              "updatedFrom",
+              "updatedTo"
+            ]
+          }
+        ]
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "data": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "id": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "description": "The business card ID."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "The business card ID."
+                },
+                "companyId": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "description": "The company ID."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "The company ID."
+                },
+                "personId": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "description": "The person ID."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "The person ID."
+                },
+                "firstName": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "description": "The first name."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "The first name."
+                },
+                "lastName": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "description": "The last name."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "The last name."
+                },
+                "companyName": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "description": "The company name."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "The company name."
+                },
+                "departmentName": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "description": "The department name."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "The department name."
+                },
+                "title": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "description": "The job title."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "The job title."
+                },
+                "email": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "description": "The email address."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "The email address."
+                },
+                "tel": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "description": "The telephone number."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "The telephone number."
+                },
+                "mobile": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "description": "The mobile phone number."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "The mobile phone number."
+                },
+                "exchangeDate": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "description": "The business card exchange date."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "The business card exchange date."
+                },
+                "registeredTime": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "description": "The registration timestamp."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "The registration timestamp."
+                },
+                "updatedTime": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "description": "The last update timestamp."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "The last update timestamp."
+                },
+                "entryStatus": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "description": "The digitization status."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "The digitization status."
+                },
+                "owner": {
+                  "type": "object",
+                  "properties": {
+                    "id": {
+                      "type": "string",
+                      "description": "The owner user ID."
+                    },
+                    "name": {
+                      "type": "string",
+                      "description": "The owner name."
+                    },
+                    "email": {
+                      "type": "string",
+                      "description": "The owner email address."
+                    }
+                  },
+                  "additionalProperties": true,
+                  "description": "The business card or tag owner."
+                },
+                "tags": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "id": {
+                        "type": "string",
+                        "description": "The tag ID."
+                      },
+                      "name": {
+                        "type": "string",
+                        "description": "The tag name."
+                      },
+                      "type": {
+                        "type": "string",
+                        "description": "The tag visibility: private, public, or shared."
+                      },
+                      "owner": {
+                        "type": "object",
+                        "properties": {
+                          "id": {
+                            "type": "string",
+                            "description": "The owner user ID."
+                          },
+                          "name": {
+                            "type": "string",
+                            "description": "The owner name."
+                          },
+                          "email": {
+                            "type": "string",
+                            "description": "The owner email address."
+                          }
+                        },
+                        "additionalProperties": true,
+                        "description": "The business card or tag owner."
+                      }
+                    },
+                    "additionalProperties": true,
+                    "description": "A Sansan tag, with additional upstream fields preserved."
+                  },
+                  "description": "Tags attached to the business card when requested."
+                }
+              },
+              "additionalProperties": true,
+              "description": "A business card with contact details; additional Sansan fields are preserved."
+            },
+            "description": "Records in this page."
+          },
+          "hasMore": {
+            "type": "boolean",
+            "description": "Whether another page is available."
+          },
+          "nextPageToken": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The next page token, or null when absent. Tokens expire six hours after the first request."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The next page token, or null when absent. Tokens expire six hours after the first request."
+          }
+        },
+        "additionalProperties": true,
+        "required": [
+          "data",
+          "hasMore",
+          "nextPageToken"
+        ],
+        "description": "One page of Sansan records."
+      }
+    },
+    {
+      "id": "sansan.list_contact_reports",
+      "service": "sansan",
+      "name": "list_contact_reports",
+      "description": "List Sansan contact reports updated within a time interval, including meetings, calls, emails, and business card exchanges.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "nextPageToken": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Continue a previous query using its nextPageToken; original query parameters are inherited."
+          },
+          "limit": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 300,
+            "description": "Maximum records per page, from 1 to 300; defaults to 100."
+          },
+          "updatedFrom": {
+            "type": "string",
+            "description": "Start of the update interval as an ISO 8601 timestamp with timezone. Required on the first page.",
+            "format": "date-time"
+          },
+          "updatedTo": {
+            "type": "string",
+            "description": "End of the update interval as an ISO 8601 timestamp with timezone. Required on the first page.",
+            "format": "date-time"
+          },
+          "range": {
+            "type": "string",
+            "enum": [
+              "me",
+              "all"
+            ],
+            "description": "Record ownership scope: me or all accessible records; defaults to me."
+          },
+          "category": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "description": "A report category."
+            },
+            "description": "Exact category names to include."
+          },
+          "type": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "enum": [
+                "Meeting",
+                "Call",
+                "Email",
+                "BizCardExchange",
+                "OnlineMeeting"
+              ],
+              "description": "A contact report type."
+            },
+            "description": "Contact report types to include."
+          },
+          "orderBy": {
+            "type": "string",
+            "enum": [
+              "registeredAt",
+              "updatedAt"
+            ],
+            "description": "Sort field; defaults to updatedAt."
+          },
+          "orderDirection": {
+            "type": "string",
+            "enum": [
+              "asc",
+              "desc"
+            ],
+            "description": "Sort direction; defaults to desc."
+          }
+        },
+        "additionalProperties": false,
+        "description": "Contact report query filters.",
+        "anyOf": [
+          {
+            "required": [
+              "nextPageToken"
+            ]
+          },
+          {
+            "required": [
+              "updatedFrom",
+              "updatedTo"
+            ]
+          }
+        ]
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "data": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "id": {
+                  "type": "string",
+                  "description": "Contact report ID."
+                },
+                "registeredTime": {
+                  "type": "string",
+                  "description": "Contact report registration timestamp."
+                },
+                "updatedTime": {
+                  "type": "string",
+                  "description": "Contact report update timestamp."
+                },
+                "startDate": {
+                  "type": "string",
+                  "description": "Interaction start date."
+                },
+                "endDate": {
+                  "type": "string",
+                  "description": "Interaction end date."
+                },
+                "startTime": {
+                  "type": "string",
+                  "description": "Interaction start timestamp."
+                },
+                "endTime": {
+                  "type": "string",
+                  "description": "Interaction end timestamp."
+                },
+                "type": {
+                  "type": "string",
+                  "description": "Recorded interaction type."
+                },
+                "title": {
+                  "type": "string",
+                  "description": "Contact report title."
+                },
+                "location": {
+                  "type": "string",
+                  "description": "Contact location."
+                },
+                "memo": {
+                  "type": "string",
+                  "description": "Contact report memo."
+                },
+                "owner": {
+                  "type": "object",
+                  "properties": {
+                    "id": {
+                      "type": "string",
+                      "description": "The owner user ID."
+                    },
+                    "name": {
+                      "type": "string",
+                      "description": "The owner name."
+                    },
+                    "email": {
+                      "type": "string",
+                      "description": "The owner email address."
+                    }
+                  },
+                  "additionalProperties": true,
+                  "description": "The business card or tag owner."
+                },
+                "externalAttendees": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "additionalProperties": true,
+                    "description": "An external participant with provider-defined contact fields."
+                  },
+                  "description": "External attendees and their business card and person IDs."
+                },
+                "internalAttendees": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "additionalProperties": true,
+                    "description": "An internal participant with provider-defined user fields."
+                  },
+                  "description": "Internal attendees and their user details."
+                },
+                "categories": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "additionalProperties": true,
+                    "description": "A category name and value."
+                  },
+                  "description": "Categories assigned to the contact report."
+                }
+              },
+              "additionalProperties": true,
+              "description": "A contact report with meeting or communication details and additional upstream fields."
+            },
+            "description": "Records in this page."
+          },
+          "hasMore": {
+            "type": "boolean",
+            "description": "Whether another page is available."
+          },
+          "nextPageToken": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The next page token, or null when absent. Tokens expire six hours after the first request."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The next page token, or null when absent. Tokens expire six hours after the first request."
+          }
+        },
+        "additionalProperties": true,
+        "required": [
+          "data",
+          "hasMore",
+          "nextPageToken"
+        ],
+        "description": "One page of Sansan records."
+      }
+    },
+    {
+      "id": "sansan.list_departments",
+      "service": "sansan",
+      "name": "list_departments",
+      "description": "List administrative department IDs, names, and parents. System administrator only.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "nextPageToken": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Continue with the next page token; original filters are inherited."
+          }
+        },
+        "additionalProperties": false,
+        "description": "Department pagination."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "data": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "id": {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "The department ID."
+                },
+                "name": {
+                  "type": "string",
+                  "description": "Department name."
+                },
+                "parentId": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "description": "Parent department ID."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "Parent department ID."
+                }
+              },
+              "additionalProperties": true,
+              "description": "An administrative department."
+            },
+            "description": "Records in this page."
+          },
+          "hasMore": {
+            "type": "boolean",
+            "description": "Whether another page is available."
+          },
+          "nextPageToken": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The next page token, or null."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The next page token, or null."
+          }
+        },
+        "additionalProperties": true,
+        "required": [
+          "data",
+          "hasMore",
+          "nextPageToken"
+        ],
+        "description": "A page of administration records."
+      }
+    },
+    {
+      "id": "sansan.list_tags",
+      "service": "sansan",
+      "name": "list_tags",
+      "description": "List Sansan tags by ownership, visibility, owner user, and tag name.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "nextPageToken": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Continue a previous query using its nextPageToken; original query parameters are inherited."
+          },
+          "limit": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 300,
+            "description": "Maximum records per page, from 1 to 300; defaults to 100."
+          },
+          "range": {
+            "type": "string",
+            "enum": [
+              "me",
+              "all"
+            ],
+            "description": "Record ownership scope: me or all accessible records; defaults to me."
+          },
+          "type": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "enum": [
+                "private",
+                "public",
+                "shared"
+              ],
+              "description": "A tag visibility type."
+            },
+            "description": "Tag visibility types to include."
+          },
+          "ownerUserId": {
+            "type": "string",
+            "maxLength": 20,
+            "description": "Tag owner user ID, effective only when range is all."
+          },
+          "tagName": {
+            "type": "string",
+            "maxLength": 50,
+            "description": "Tag name substring."
+          }
+        },
+        "additionalProperties": false,
+        "description": "Tag query filters."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "data": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "id": {
+                  "type": "string",
+                  "description": "The tag ID."
+                },
+                "name": {
+                  "type": "string",
+                  "description": "The tag name."
+                },
+                "type": {
+                  "type": "string",
+                  "description": "The tag visibility: private, public, or shared."
+                },
+                "owner": {
+                  "type": "object",
+                  "properties": {
+                    "id": {
+                      "type": "string",
+                      "description": "The owner user ID."
+                    },
+                    "name": {
+                      "type": "string",
+                      "description": "The owner name."
+                    },
+                    "email": {
+                      "type": "string",
+                      "description": "The owner email address."
+                    }
+                  },
+                  "additionalProperties": true,
+                  "description": "The business card or tag owner."
+                }
+              },
+              "additionalProperties": true,
+              "description": "A Sansan tag, with additional upstream fields preserved."
+            },
+            "description": "Records in this page."
+          },
+          "hasMore": {
+            "type": "boolean",
+            "description": "Whether another page is available."
+          },
+          "nextPageToken": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The next page token, or null when absent. Tokens expire six hours after the first request."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The next page token, or null when absent. Tokens expire six hours after the first request."
+          }
+        },
+        "additionalProperties": true,
+        "required": [
+          "data",
+          "hasMore",
+          "nextPageToken"
+        ],
+        "description": "One page of Sansan records."
+      }
+    },
+    {
+      "id": "sansan.search_business_cards",
+      "service": "sansan",
+      "name": "search_business_cards",
+      "description": "Search accessible Sansan business cards by company, name, email, telephone, mobile, and tags.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "nextPageToken": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Continue a previous query using its nextPageToken; original query parameters are inherited."
+          },
+          "limit": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 300,
+            "description": "Maximum records per page, from 1 to 300; defaults to 100."
+          },
+          "range": {
+            "type": "string",
+            "enum": [
+              "me",
+              "all"
+            ],
+            "description": "Record ownership scope: me or all accessible records; defaults to me."
+          },
+          "includeTags": {
+            "type": "boolean",
+            "description": "Include attached tags and treat tag changes as business card updates."
+          },
+          "includePastBizCards": {
+            "type": "boolean",
+            "description": "Include older business cards for merged persons; defaults to false."
+          },
+          "entryStatus": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "enum": [
+                "processing",
+                "completed",
+                "unreadable"
+              ],
+              "description": "A business card digitization status."
+            },
+            "description": "Digitization statuses to include; defaults to completed."
+          },
+          "orderBy": {
+            "type": "string",
+            "enum": [
+              "registeredAt",
+              "completedAt",
+              "updatedAt"
+            ],
+            "description": "Sort field; defaults to updatedAt for listing and registeredAt for searching."
+          },
+          "orderDirection": {
+            "type": "string",
+            "enum": [
+              "asc",
+              "desc"
+            ],
+            "description": "Sort direction; defaults to asc for listing and desc for searching."
+          },
+          "companyName": {
+            "type": "string",
+            "description": "Company name substring."
+          },
+          "name": {
+            "type": "string",
+            "description": "Name prefix."
+          },
+          "email": {
+            "type": "string",
+            "description": "Exact email address."
+          },
+          "tel": {
+            "type": "string",
+            "description": "Telephone number substring."
+          },
+          "mobile": {
+            "type": "string",
+            "description": "Mobile number substring."
+          },
+          "tagIds": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1,
+              "description": "A tag ID."
+            },
+            "description": "Filter by one or more Sansan tag IDs."
+          }
+        },
+        "additionalProperties": false,
+        "description": "Business card search filters."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "data": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "id": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "description": "The business card ID."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "The business card ID."
+                },
+                "companyId": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "description": "The company ID."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "The company ID."
+                },
+                "personId": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "description": "The person ID."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "The person ID."
+                },
+                "firstName": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "description": "The first name."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "The first name."
+                },
+                "lastName": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "description": "The last name."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "The last name."
+                },
+                "companyName": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "description": "The company name."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "The company name."
+                },
+                "departmentName": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "description": "The department name."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "The department name."
+                },
+                "title": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "description": "The job title."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "The job title."
+                },
+                "email": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "description": "The email address."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "The email address."
+                },
+                "tel": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "description": "The telephone number."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "The telephone number."
+                },
+                "mobile": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "description": "The mobile phone number."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "The mobile phone number."
+                },
+                "exchangeDate": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "description": "The business card exchange date."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "The business card exchange date."
+                },
+                "registeredTime": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "description": "The registration timestamp."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "The registration timestamp."
+                },
+                "updatedTime": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "description": "The last update timestamp."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "The last update timestamp."
+                },
+                "entryStatus": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "description": "The digitization status."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "The digitization status."
+                },
+                "owner": {
+                  "type": "object",
+                  "properties": {
+                    "id": {
+                      "type": "string",
+                      "description": "The owner user ID."
+                    },
+                    "name": {
+                      "type": "string",
+                      "description": "The owner name."
+                    },
+                    "email": {
+                      "type": "string",
+                      "description": "The owner email address."
+                    }
+                  },
+                  "additionalProperties": true,
+                  "description": "The business card or tag owner."
+                },
+                "tags": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "id": {
+                        "type": "string",
+                        "description": "The tag ID."
+                      },
+                      "name": {
+                        "type": "string",
+                        "description": "The tag name."
+                      },
+                      "type": {
+                        "type": "string",
+                        "description": "The tag visibility: private, public, or shared."
+                      },
+                      "owner": {
+                        "type": "object",
+                        "properties": {
+                          "id": {
+                            "type": "string",
+                            "description": "The owner user ID."
+                          },
+                          "name": {
+                            "type": "string",
+                            "description": "The owner name."
+                          },
+                          "email": {
+                            "type": "string",
+                            "description": "The owner email address."
+                          }
+                        },
+                        "additionalProperties": true,
+                        "description": "The business card or tag owner."
+                      }
+                    },
+                    "additionalProperties": true,
+                    "description": "A Sansan tag, with additional upstream fields preserved."
+                  },
+                  "description": "Tags attached to the business card when requested."
+                }
+              },
+              "additionalProperties": true,
+              "description": "A business card with contact details; additional Sansan fields are preserved."
+            },
+            "description": "Records in this page."
+          },
+          "hasMore": {
+            "type": "boolean",
+            "description": "Whether another page is available."
+          },
+          "nextPageToken": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The next page token, or null when absent. Tokens expire six hours after the first request."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The next page token, or null when absent. Tokens expire six hours after the first request."
+          }
+        },
+        "additionalProperties": true,
+        "required": [
+          "data",
+          "hasMore",
+          "nextPageToken"
+        ],
+        "description": "One page of Sansan records."
+      }
+    },
+    {
+      "id": "sansan.set_default_email_client",
+      "service": "sansan",
+      "name": "set_default_email_client",
+      "description": "Set the default email client for subsequently added users; users may change it later. System administrator only.",
+      "operationType": "write",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "emailClient": {
+            "type": "string",
+            "enum": [
+              "clientSoftware",
+              "gmail",
+              "office365"
+            ],
+            "description": "Default email client for newly added users."
+          },
+          "encoding": {
+            "type": "string",
+            "enum": [
+              "sjis",
+              "utf8",
+              "iso2022jp"
+            ],
+            "description": "Required only for clientSoftware."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "emailClient"
+        ],
+        "description": "Default email client settings.",
+        "allOf": [
+          {
+            "if": {
+              "properties": {
+                "emailClient": {
+                  "const": "clientSoftware"
+                }
+              }
+            },
+            "then": {
+              "required": [
+                "encoding"
+              ]
+            },
+            "else": {
+              "not": {
+                "required": [
+                  "encoding"
+                ]
+              }
+            }
+          }
+        ]
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "settings": {
+            "anyOf": [
+              {
+                "type": "object",
+                "properties": {
+                  "emailClient": {
+                    "type": "string",
+                    "enum": [
+                      "clientSoftware",
+                      "gmail",
+                      "office365"
+                    ],
+                    "description": "Default email client for newly added users."
+                  },
+                  "encoding": {
+                    "type": "string",
+                    "enum": [
+                      "sjis",
+                      "utf8",
+                      "iso2022jp"
+                    ],
+                    "description": "Required only for clientSoftware."
+                  }
+                },
+                "additionalProperties": true,
+                "description": "Email client configuration."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Email client configuration."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "settings"
+        ],
+        "description": "Organization default email client; null when not configured."
+      }
+    },
+    {
+      "id": "sansan.set_department_access_control",
+      "service": "sansan",
+      "name": "set_department_access_control",
+      "description": "Assign an access control pattern to a department. System administrator only.",
+      "operationType": "write",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "departmentId": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The department ID."
+          },
+          "aclPatternId": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The access control pattern ID."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "departmentId",
+          "aclPatternId"
+        ],
+        "description": "Department and pattern assignment."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "success": {
+            "type": "boolean",
+            "description": "Whether the request succeeded."
+          },
+          "data": {
+            "anyOf": [
+              {
+                "type": "object",
+                "additionalProperties": true,
+                "description": "Any JSON payload returned by Sansan."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Any JSON payload returned by Sansan."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "success",
+          "data"
+        ],
+        "description": "Successful administration change."
+      }
+    },
+    {
+      "id": "sansan.submit_organization_import",
+      "service": "sansan",
+      "name": "submit_organization_import",
+      "description": "Submit user and department additions, updates, or deletions. System administrator only. DeleteFlag can delete users or departments; preserve the import ID to retrieve results.",
+      "operationType": "destructive",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "users": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "TempId": {
+                  "type": "string",
+                  "maxLength": 256,
+                  "description": "Temporary alphanumeric ID for a new user; blank when editing. Must be unique within the file."
+                },
+                "UserUuid": {
+                  "type": "string",
+                  "description": "Existing user UUID when editing; blank for a new user."
+                },
+                "DepartmentId": {
+                  "type": "string",
+                  "description": "Department IDs separated by semicolons; use tempId:ID for a new department in the same import."
+                },
+                "UserId": {
+                  "type": "string",
+                  "maxLength": 20,
+                  "description": "Immutable user login ID, up to 20 characters; alphanumeric or .-_&."
+                },
+                "UserName": {
+                  "type": "string",
+                  "maxLength": 60,
+                  "description": "User display name, up to 60 characters."
+                },
+                "AlternativeName": {
+                  "type": "string",
+                  "maxLength": 256,
+                  "description": "User name reading."
+                },
+                "Email": {
+                  "type": "string",
+                  "maxLength": 60,
+                  "description": "Unique primary user email within the company."
+                },
+                "SubEmail": {
+                  "type": "string",
+                  "maxLength": 60,
+                  "description": "Secondary user email."
+                },
+                "EffectiveDateFrom": {
+                  "type": "string",
+                  "description": "Usage start date for new users, today or later in RFC3339 format; blank when unchanged during editing."
+                },
+                "SamlNameId": {
+                  "type": "string",
+                  "description": "Unique SAML Name ID within the company."
+                },
+                "Culture": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 2,
+                  "description": "Display language: 0 Japanese, 1 English, 2 Simplified Chinese. Omission serializes as a blank CSV cell."
+                },
+                "MailFormat": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 1,
+                  "description": "Email format: 0 HTML, 1 text. Omission serializes as a blank CSV cell."
+                },
+                "UserType": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 2,
+                  "description": "Role: 0 regular, 1 system administrator, 2 departmental administrator. Omission serializes as a blank CSV cell."
+                },
+                "CanUpdateData": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 1,
+                  "description": "Permission to update all data: 1 granted, 0 denied. Omission serializes as a blank CSV cell."
+                },
+                "DataDownloadPrivilege": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 3,
+                  "description": "Download permission: 0 none, 1 own data, 2 all data, 3 assigned departments. Omission serializes as a blank CSV cell."
+                },
+                "EmailDeliveryPrivilege": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 1,
+                  "description": "Email delivery permission: 1 granted, 0 denied. Omission serializes as a blank CSV cell."
+                },
+                "DealPrivilege": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 2,
+                  "description": "Deal permission: 0 none, 1 regular, 2 administrator. Omission serializes as a blank CSV cell."
+                },
+                "ApiIntegrationPrivilege": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 1,
+                  "description": "API integration permission: 1 granted, 0 denied. Omission serializes as a blank CSV cell."
+                },
+                "UsageStatisticsPrivilege": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 1,
+                  "description": "Usage statistics permission: 1 granted, 0 denied. Omission serializes as a blank CSV cell."
+                },
+                "OrganizationTreeDownloadPrivilege": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 1,
+                  "description": "Organization tree download permission: 1 granted, 0 denied. Omission serializes as a blank CSV cell."
+                },
+                "DeleteFlag": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 1,
+                  "description": "Set to 1 to delete the user. Omission serializes as a blank CSV cell."
+                },
+                "SalesforceIntegrationPrivilege": {
+                  "type": "string",
+                  "description": "Retired field, ignored by Sansan; the CSV column is retained even when omitted."
+                }
+              },
+              "additionalProperties": false,
+              "description": "A user import row using official Sansan CSV columns. Submission requires DepartmentId, UserId, UserName and Email; new users also require TempId and EffectiveDateFrom, while existing users require UserUuid. Blank optional cells preserve unchanged values when editing."
+            },
+            "description": "Structured user rows; Connector builds the official CSV, preserving all columns. Mutually exclusive with usersFileUrl.",
+            "minItems": 1
+          },
+          "departments": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "TempId": {
+                  "type": "string",
+                  "maxLength": 256,
+                  "description": "Temporary alphanumeric ID for a new department; blank when editing."
+                },
+                "DepartmentId": {
+                  "type": "string",
+                  "description": "Existing department ID when editing; blank for a new department."
+                },
+                "DepartmentName": {
+                  "type": "string",
+                  "maxLength": 30,
+                  "description": "Department name."
+                },
+                "DepartmentNamePhonetic": {
+                  "type": "string",
+                  "maxLength": 256,
+                  "description": "Department name reading using lowercase Latin letters, digits, and spaces."
+                },
+                "ParentDepartmentId": {
+                  "type": "string",
+                  "description": "Parent department ID or tempId:ID for a parent created in the same import; blank for no parent."
+                },
+                "Order": {
+                  "type": "integer",
+                  "description": "Department sort order."
+                },
+                "DeleteFlag": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 1,
+                  "description": "Set to 1 to delete the department; it must have no users or child departments."
+                }
+              },
+              "additionalProperties": false,
+              "description": "A department import row using official Sansan CSV columns. Submission requires DepartmentName and either TempId for creation or DepartmentId for editing; the other identifier must be blank or omitted."
+            },
+            "description": "Structured department rows. Mutually exclusive with departmentsFileUrl.",
+            "minItems": 1
+          },
+          "usersFileUrl": {
+            "type": "string",
+            "description": "Public URL of a UTF-8 user CSV with a header row; maximum 20 MiB per source file.",
+            "format": "uri"
+          },
+          "departmentsFileUrl": {
+            "type": "string",
+            "description": "Public URL of a UTF-8 department CSV with a header row; maximum 20 MiB per source file.",
+            "format": "uri"
+          },
+          "delimiter": {
+            "type": "string",
+            "enum": [
+              "comma",
+              "semicolon",
+              "tab",
+              "space"
+            ],
+            "description": "CSV delimiter; defaults to comma."
+          }
+        },
+        "additionalProperties": false,
+        "description": "Users and/or departments to check or import. System administrator only.",
+        "anyOf": [
+          {
+            "required": [
+              "users"
+            ]
+          },
+          {
+            "required": [
+              "departments"
+            ]
+          },
+          {
+            "required": [
+              "usersFileUrl"
+            ]
+          },
+          {
+            "required": [
+              "departmentsFileUrl"
+            ]
+          }
+        ],
+        "allOf": [
+          {
+            "not": {
+              "required": [
+                "users",
+                "usersFileUrl"
+              ]
+            }
+          },
+          {
+            "not": {
+              "required": [
+                "departments",
+                "departmentsFileUrl"
+              ]
+            }
+          },
+          {
+            "properties": {
+              "users": {
+                "items": {
+                  "required": [
+                    "DepartmentId",
+                    "UserId",
+                    "UserName",
+                    "Email"
+                  ],
+                  "properties": {
+                    "DepartmentId": {
+                      "minLength": 1
+                    },
+                    "UserId": {
+                      "minLength": 1
+                    },
+                    "UserName": {
+                      "minLength": 1
+                    },
+                    "Email": {
+                      "minLength": 1
+                    }
+                  },
+                  "oneOf": [
+                    {
+                      "required": [
+                        "TempId",
+                        "EffectiveDateFrom"
+                      ],
+                      "properties": {
+                        "TempId": {
+                          "minLength": 1
+                        },
+                        "UserUuid": {
+                          "maxLength": 0
+                        },
+                        "EffectiveDateFrom": {
+                          "minLength": 1
+                        }
+                      }
+                    },
+                    {
+                      "required": [
+                        "UserUuid"
+                      ],
+                      "properties": {
+                        "UserUuid": {
+                          "minLength": 1
+                        },
+                        "TempId": {
+                          "maxLength": 0
+                        }
+                      }
+                    }
+                  ]
+                }
+              },
+              "departments": {
+                "items": {
+                  "required": [
+                    "DepartmentName"
+                  ],
+                  "properties": {
+                    "DepartmentName": {
+                      "minLength": 1
+                    }
+                  },
+                  "oneOf": [
+                    {
+                      "required": [
+                        "TempId"
+                      ],
+                      "properties": {
+                        "TempId": {
+                          "minLength": 1
+                        },
+                        "DepartmentId": {
+                          "maxLength": 0
+                        }
+                      }
+                    },
+                    {
+                      "required": [
+                        "DepartmentId"
+                      ],
+                      "properties": {
+                        "DepartmentId": {
+                          "minLength": 1
+                        },
+                        "TempId": {
+                          "maxLength": 0
+                        }
+                      }
+                    }
+                  ]
+                }
+              }
+            }
+          }
+        ]
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "importId": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The submitted import job ID."
+          }
+        },
+        "additionalProperties": true,
+        "required": [
+          "importId"
+        ],
+        "description": "Submitted organization import."
+      },
+      "asyncLifecycle": {
+        "startActionId": "sansan.submit_organization_import",
+        "statusActionId": "sansan.get_organization_import_result"
+      }
+    },
+    {
+      "id": "sansan.update_access_control_pattern",
+      "service": "sansan",
+      "name": "update_access_control_pattern",
+      "description": "Update an access control pattern and its department rules. System administrator only.",
+      "operationType": "write",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "patternId": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The access control pattern ID."
+          },
+          "aclPatternName": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Access control pattern name."
+          },
+          "description": {
+            "type": "string",
+            "description": "Access control pattern description."
+          },
+          "details": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "objectDepartmentId": {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "The department whose data this rule covers."
+                },
+                "accessibleFieldsSettingsName": {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "The upstream accessible-fields setting name, such as ALL. Use values configured in Sansan; no complete enum is published."
+                }
+              },
+              "additionalProperties": true,
+              "required": [
+                "objectDepartmentId",
+                "accessibleFieldsSettingsName"
+              ],
+              "description": "Access rule for a target department; additional provider-defined fields are accepted."
+            },
+            "description": "Department access rules."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "patternId"
+        ],
+        "description": "Access control pattern changes."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "success": {
+            "type": "boolean",
+            "description": "Whether the request succeeded."
+          },
+          "data": {
+            "anyOf": [
+              {
+                "type": "object",
+                "additionalProperties": true,
+                "description": "Any JSON payload returned by Sansan."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Any JSON payload returned by Sansan."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "success",
+          "data"
+        ],
+        "description": "Successful administration change."
+      }
+    },
+    {
+      "id": "sansan.upload_business_card_image",
+      "service": "sansan",
+      "name": "upload_business_card_image",
+      "description": "Submit JPEG business card images for paid Sansan digitization. Optionally use administrator import for another owner.",
+      "operationType": "write",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "ownerUserId": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Optional record owner user ID. When provided, use the system-administrator import API; the user must belong to the same company and contract. Omit to create for the connected user."
+          },
+          "frontImageUrl": {
+            "type": "string",
+            "description": "Public URL of the front JPEG image, at most 5 MB.",
+            "format": "uri"
+          },
+          "backImageUrl": {
+            "type": "string",
+            "description": "Public URL of the optional back JPEG image, at most 5 MB.",
+            "format": "uri"
+          },
+          "exchangeDate": {
+            "type": "string",
+            "description": "Business card exchange date, YYYY-MM-DD.",
+            "format": "date"
+          },
+          "prioritizeHandWrittenDates": {
+            "type": "boolean",
+            "description": "Use a handwritten date on the image as the exchange date."
+          },
+          "memo": {
+            "type": "string",
+            "maxLength": 2000,
+            "description": "Memo attached to the imported card."
+          },
+          "languages": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "enum": [
+                "Japanese",
+                "English",
+                "Chinese",
+                "Korean",
+                "Spanish",
+                "Portuguese",
+                "German",
+                "French",
+                "Thai",
+                "Indonesian",
+                "Vietnamese"
+              ],
+              "description": "A supported digitization language."
+            },
+            "description": "Requested digitization languages, at most two.",
+            "maxItems": 2
+          },
+          "tagIds": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1,
+              "description": "An existing tag ID."
+            },
+            "description": "Existing tag IDs to attach, at most fifteen.",
+            "maxItems": 15
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "frontImageUrl"
+        ],
+        "description": "Image URLs and digitization options."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "data": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "id": {
+                  "type": "string",
+                  "description": "The created business card ID."
+                },
+                "language": {
+                  "type": "string",
+                  "description": "The digitization language."
+                }
+              },
+              "additionalProperties": true,
+              "description": "A card queued for digitization."
+            },
+            "description": "Created card identifiers for each requested language."
+          }
+        },
+        "additionalProperties": true,
+        "required": [
+          "data"
+        ],
+        "description": "Business cards submitted for paid digitization."
+      }
+    }
+  ]
+}