CreateMonitorTask

创建监测任务 BytePlus Market Insight monitor operation. Requires an AIsa API key and owner-scoped TaskID for existing tasks. Only POST JSON on the canonical path is supported; URL query parameters, proxy aliases, MPP and cost quotes are rejected. Request validation is owned by the handler; provider-specific Config fields and PullPosts filters are forwarded. Existing V2 customer pricing applies. <!-- aisa-pricing:start --> Published reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ. <!-- aisa-pricing:end -->

POST https://api.aisa.one/apis/v1/byteplus/mkt-insight/CreateMonitorTask

CreateMonitorTask

cURL

curl --request POST \
  --url https://api.aisa.one/apis/v1/byteplus/mkt-insight/CreateMonitorTask \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "ClientToken": "monitor-example-1",
  "Config": {
    "RuleExpression": "OpenAI",
    "TaskName": "Example monitor"
  }
}
'

Request contract

• Method and path: POST /apis/v1/byteplus/mkt-insight/CreateMonitorTask
• Request URL template: https://api.aisa.one/apis/v1/byteplus/mkt-insight/CreateMonitorTask
• Runtime facts: 3e676d124d8358413f32c7d401f389360bf33713ad8177fd31f81d8ab4eaaf4a

Complete OpenAPI definition

Effective request and pricing declaration (including authentication and referenced schemas):

{
  "operationId": "post_byteplus_market_insight_apis_v1_byteplus_mkt_4733a5",
  "method": "POST",
  "path": "/apis/v1/byteplus/mkt-insight/CreateMonitorTask",
  "servers": [
    {
      "url": "https://api.aisa.one"
    }
  ],
  "parameters": [],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "requestBody": {
    "content": {
      "application/json": {
        "examples": {
          "validated_request": {
            "value": {
              "ClientToken": "monitor-example-1",
              "Config": {
                "RuleExpression": "OpenAI",
                "TaskName": "Example monitor"
              }
            }
          }
        },
        "schema": {
          "additionalProperties": false,
          "description": "One JSON object with exact, case-sensitive root field names. Unknown and duplicate root fields are rejected. URL query parameters are not supported.",
          "properties": {
            "ClientToken": {
              "description": "Required nonblank idempotency token, at most 128 UTF-8 bytes before trimming. Reuse only with the identical request.",
              "minLength": 1,
              "type": "string",
              "x-aisa-max-utf8-bytes": 128
            },
            "Config": {
              "additionalProperties": true,
              "description": "TaskName and RuleExpression are required and must be nonblank. Config fields follow Go JSON case-insensitive matching and last-value behavior; additional provider fields are forwarded. Required-field, whitespace and byte checks apply in the runtime validator.",
              "properties": {
                "RelatedRequirement": {
                  "description": "Optional. Missing, null and empty string are accepted; a nonempty string containing only whitespace is rejected.",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "RuleExpression": {
                  "description": "Required nonblank provider rule expression; grammar is validated by BytePlus.",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "TaskName": {
                  "description": "Required nonblank task name; trimmed UTF-8 length must be less than 255 bytes.",
                  "type": [
                    "string",
                    "null"
                  ],
                  "x-aisa-max-trimmed-utf8-bytes": 254
                }
              },
              "type": "object",
              "x-aisa-required-fields-case-insensitive": [
                "TaskName",
                "RuleExpression"
              ]
            }
          },
          "required": [
            "ClientToken",
            "Config"
          ],
          "type": "object"
        }
      }
    },
    "required": true
  },
  "x-aisa-pricing": {
    "cost_contract": "fixed_success",
    "customer_pricing": "fixed_success",
    "default_request_estimate_usd": 0.01,
    "estimate_source": "profile_seed",
    "evidence_source": "request_snapshot"
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "scheme": "bearer",
        "type": "http"
      }
    }
  }
}

Cost and request rules

Published reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.

Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.

• Default request reference estimate (USD): 0.01
• Cost contract: fixed_success
• Settlement evidence source: request_snapshot

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

One JSON object with exact, case-sensitive root field names. Unknown and duplicate root fields are rejected. URL query parameters are not supported.

ClientToken · string · required

Required nonblank idempotency token, at most 128 UTF-8 bytes before trimming. Reuse only with the identical request.

Minimum string length: 1

Config · object · required

TaskName and RuleExpression are required and must be nonblank. Config fields follow Go JSON case-insensitive matching and last-value behavior; additional provider fields are forwarded. Required-field, whitespace and byte checks apply in the runtime validator.

Show child attributes

Response

200

Successful response