# Create Support Tool

POST /api/v2/projects/{projectId}/support/tools

Creates one support tool the support agent can call.

## Request

- projectId: string, path, required — ID of the project that will own the tool.
- tool: object, required — Tool to create. Field descriptions on this object are the authoring contract.
  - description: string, required
  - enabled: boolean, required — When false, an active tool is paused and is not offered to the visitor.
  - inputSchema: object, required — JSON Schema object (type "object") of arguments the model fills. Names listed in contextParameters or serverParameters are not left for the model.
    - type: string, required
    - additionalProperties: value
    - properties: object
    - required: string[]
  - name: string, required — Display name. It is normalized into the identifier the agent calls.
  - status: draft | active, required — draft is saved but not offered to the agent. active is offered when enabled is true.
  - activationConditions: object[]
    - field: string, required
    - operator: IS_SET | IS_NOT_SET | EQUALS | NOT_EQUALS | CONTAINS | NOT_CONTAINS | GREATER_THAN | GREATER_THAN_OR_EQUAL | LESS_THAN | LESS_THAN_OR_EQUAL, required
    - value: string
  - approval: none | user — "user" asks the visitor to confirm before the call. "none" runs immediately. Omitted means none.
  - authHeaderName: string — Header name for authType "apiKey", such as X-API-Key. The token is read from the integration, not from this field.
  - authSource: object — Where the auth token is stored. { kind: "integration", integrationId } or { kind: "integration", serviceName }. Never send the token or the integration key.
    - kind: string, required
    - integrationId: string

…

## Response

- 200: Successful response
  - authConfigured: boolean, required — Whether this tool resolves an auth token from an integration. The token and the integration key are not returned.
  - description: string, required
  - enabled: boolean, required — When false, an active tool is paused and is not offered to the visitor.
  - execution: host | server, required, default host — host runs in the visitor's browser. server is proxied by Saasco. An MCP tool is server with source.kind "mcp".
  - id: string, required
  - inputSchema: object, required — JSON Schema object (type "object") of arguments the model fills. Names listed in contextParameters or serverParameters are not left for the model.
    - type: string, required
    - additionalProperties: value
    - properties: object
    - required: string[]
  - name: string, required — Display name. It is normalized into the identifier the agent calls.
  - status: draft | active, required — draft is saved but not offered to the agent. active is offered when enabled is true.
  - activationConditions: object[]
    - field: string, required
    - operator: IS_SET | IS_NOT_SET | EQUALS | NOT_EQUALS | CONTAINS | NOT_CONTAINS | GREATER_THAN | GREATER_THAN_OR_EQUAL | LESS_THAN | LESS_THAN_OR_EQUAL, required
    - value: string
  - approval: none | user — "user" asks the visitor to confirm before the call. "none" runs immediately. Omitted means none.
  - authHeaderName: string — Header name for authType "apiKey", such as X-API-Key. The token is read from the integration, not from this field.
  - authSource: object — Where the auth token is sto
…
