Jump to

• Request
• Response
• Examples

Generate Project Business Policy JavaScript

post

/ic/api/integration/v1/projects/{projectId}/mcp/policies/business/actions/generate

Generates JavaScript for a project MCP business policy from a selected MCP server tool and free-text business rule prompt.

Request

Path Parameters

• projectId(required): string
  Project identifier

  Example:

  MCP_PROJECT

Query Parameters

• integrationInstance(required): string
  This is the name of the service instance. You can get this value from the About page where it is specified in the Service instance field.

  Example:

  example-instance

Supported Media Types

• application/json; charset=utf-8

Request Body - application/json; charset=utf-8 ()

Root Schema : schema

Type: object

Business policy JavaScript generation request.

Show Source

• prompt(required): string
  Free-text business policy requirements.
• serverId(required): string
  Project MCP server id.
• toolName(required): string
  MCP tool name exposed by the selected server.

{
    "type":"object",
    "properties":{
        "serverId":{
            "type":"string",
            "description":"Project MCP server id."
        },
        "toolName":{
            "type":"string",
            "description":"MCP tool name exposed by the selected server."
        },
        "prompt":{
            "type":"string",
            "description":"Free-text business policy requirements."
        }
    },
    "description":"Business policy JavaScript generation request.",
    "required":[
        "serverId",
        "toolName",
        "prompt"
    ]
}

Back to Top

Response

Supported Media Types

• application/json; charset=utf-8

200 Response

Successful operation

Body ()

Root Schema : MCPBusinessPolicyGenerateResponseRs

Type: object

Generated business policy JavaScript response.

Show Source

• config: object config
  Additional Properties Allowed: true

  Policy-type-specific configuration. Its required fields depend on the policy type.
• javascript: string
  Generated business policy JavaScript.
• serverId: string
  Identifier of the project MCP server.
• toolName: string
  Name of the selected MCP server tool.
• warnings: array warnings
  Warnings produced while generating the policy.

{
    "type":"object",
    "properties":{
        "serverId":{
            "type":"string",
            "description":"Identifier of the project MCP server."
        },
        "toolName":{
            "type":"string",
            "description":"Name of the selected MCP server tool."
        },
        "javascript":{
            "type":"string",
            "description":"Generated business policy JavaScript."
        },
        "config":{
            "type":"object",
            "additionalProperties":true,
            "description":"Policy-type-specific configuration. Its required fields depend on the policy type."
        },
        "warnings":{
            "type":"array",
            "items":{
                "type":"string"
            },
            "description":"Warnings produced while generating the policy."
        }
    },
    "description":"Generated business policy JavaScript response."
}

Nested Schema : config

Type: object

Additional Properties Allowed: true

Policy-type-specific configuration. Its required fields depend on the policy type.

Nested Schema : warnings

Type: array

Warnings produced while generating the policy.

Show Source

• Array of: string

{
    "type":"array",
    "items":{
        "type":"string"
    },
    "description":"Warnings produced while generating the policy."
}

400 Response

Malformed parameters

401 Response

Unauthorized or insufficient design-time permissions

404 Response

Project or resource not found, or the MCP feature is not available

500 Response

Server error

Back to Top

Examples

The following example shows how to generate JavaScript for a project MCP business policy from a selected MCP server tool and a free-text business rule prompt by submitting a POST request on the REST resource using cURL. For more information about cURL, see Use cURL. For more information about endpoint URL structure, see Send Requests.

Example: Generate Project Business Policy JavaScript

curl --request POST --include \
  --url "${BASE_URL}/ic/api/integration/v1/projects/${PROJECT_ID}/mcp/policies/business/actions/generate?integrationInstance=${INTEGRATION_INSTANCE}" \
  --header "Authorization: Bearer ${ACCESS_TOKEN}" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json; charset=utf-8" \
  --data-raw '{
  "serverId": "MCP_SERVER",
  "toolName": "get_weather",
  "prompt": "Allow the request only when the city argument is non-empty. Otherwise deny the request."
}'

Back to Top