Configure licensed index observations

configure_licensed_index_observations Configure the initial US/en licensed source-search observation lane for one project. Activation and supplier funding require separate operator admission.

Development preview. This command is absent from the verified deployed bundle. Use a matching development environment.

Access	Behavior
`discovery:write`, `watches:write`	Writes or admits work; can change or remove existing state

This operation changes saved state. Review its inputs and retry behavior before calling.

Example request

Connect through MCP, CLI, or HTTP. Replace example identifiers with records from your workspace.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "configure_licensed_index_observations",
    "arguments": {
      "projectId": "project_example",
      "enabled": false,
      "locationCode": 2840,
      "language": "en",
      "country": "US"
    }
  }
}

agentlinkops call configure_licensed_index_observations --args '{"projectId":"project_example","enabled":false,"locationCode":2840,"language":"en","country":"US"}'

curl "$AGENTLINKOPS_API_URL/v1/commands/configure_licensed_index_observations" \
  -H "Authorization: Bearer $AGENTLINKOPS_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{"projectId":"project_example","enabled":false,"locationCode":2840,"language":"en","country":"US"}'

Returned result

Illustrative data validated against the documented response schema. IDs and dates are examples, not a live account capture. MCP returns this data in structuredContent and in a text content block; generic HTTP and CLI return the JSON result directly.

{
  "projectId": "pr_example",
  "settings": null,
  "transportEnabled": false
}

Input fields

Omit optional fields when you do not want to supply them. Null is accepted only where listed. Unknown input properties are rejected.

Field	Type	Presence	Meaning and constraints
`projectId`	string	Required	Identifier of the project returned by its create or list operation. minLength: 1; maxLength: 200
`enabled`	boolean	Required	The enabled value; allowed values and bounds are specified in this schema.
`locationCode`	number	Required	The location code value; allowed values and bounds are specified in this schema. must equal 2840
`language`	string	Required	The language value; allowed values and bounds are specified in this schema. must equal “en”
`country`	string	Required	The country value; allowed values and bounds are specified in this schema. must equal “US”
`dailyLimit`	integer	Optional	The daily limit value; allowed values and bounds are specified in this schema. minimum: 1; maximum: 1000; default: 10
`retentionDays`	integer	Optional	The retention days value; allowed values and bounds are specified in this schema. minimum: 1; maximum: 90; default: 30
`expectedRevision`	integer / null	Optional	Revision last read by the caller; mismatches reject concurrent updates.

Validation and omitted values

Customer input cannot supply funding policies, credentials, raw supplier results or costs. Managed supplier admission requires current workspace/project access, explicit opt-in, a default-off transport flag and five current shared budget policies bound to the supplier account and tariff. Initial search scope is one US/en Google organic site query at location 2840 and depth 10. The pilot limits non-cancelled requests to 10 per workspace, project, funding reference and UTC calendar month; unknown charges hold capacity and never authorize an automatic paid retry. These are dated sampled search observations. An exact returned URL can be likely_indexed; a missing sample is not_found_in_site_query. Neither sampled absence nor transport failure establishes Google-confirmed deindexing or backlink loss. Owner/admin writes require watches:write and discovery:write. Defaults: 10 attempts/day and 30 raw-retention days. Configuration does not activate transport or fund the supplier.

Defaults when omitted

Field	Default
`dailyLimit`	`10`
`retentionDays`	`30`

Output fields

Fields inside optional or nullable parents apply only when that parent exists. Common schema conventions explain evidence states, empty lists and extensions.

Field	Type	Presence	Meaning and constraints
`projectId`	string	Required	Identifier returned by the related operation. minLength: 1; maxLength: 200
`settings`	object / null	Required
`settings.projectId`	string	Required	Identifier returned by the related operation. minLength: 1; maxLength: 200
`settings.enabled`	boolean	Required
`settings.revision`	integer	Required	Optimistic concurrency revision; supply it as expectedRevision on the next write. maximum: 9007199254740991; exclusiveMinimum: 0
`settings.locationCode`	number	Required	must equal 2840
`settings.language`	string	Required	must equal “en”
`settings.country`	string	Required	must equal “US”
`settings.dailyLimit`	integer	Required	maximum: 9007199254740991; exclusiveMinimum: 0
`settings.retentionDays`	integer	Required	maximum: 9007199254740991; exclusiveMinimum: 0
`settings.updatedAt`	string	Required	format: “date-time”; pattern: ”^(?:(?:\d\d[2468][048]\|\d\d[13579][26]\|\d\d0[48]\|[02468][048]00\|[13579][26]00)-02-29\|\d{4}-(?:(?:0[13578]\|1[02])-(?:0[1-9]\|[12]\d\|3[01])\|(?:0[469]\|11)-(?:0[1-9]\|[12]\d\|30)\|(?:02)-(?:0[1-9]\|1\d\|2[0-8])))T(?:(?:[01]\d\|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$“
`transportEnabled`	boolean	Required

Download input schema · Download output schema

Errors and retries

The command is annotated idempotent. Reuse an accepted idempotency key when the input provides one; changing the payload under a reused key can conflict. See error recovery for status, scope, cooldown, cursor and retry handling. Unknown observations are result data and do not establish loss.

HTTP resource routes

This operation has no separate resource alias. Use its generic command route in a matching environment.

Continue

get_licensed_index_settings Follow the related workflow, inspect capability status, or return to the command index.

Overview

MCP, CLI and API commands

CLI client

HTTP and events

Optional local workflows

Configure licensed index observations

Example request

Returned result

Input fields

Validation and omitted values

Defaults when omitted

Output fields

Errors and retries

HTTP resource routes

Continue

​Example request

​Returned result

​Input fields

​Validation and omitted values

​Defaults when omitted

​Output fields

​Errors and retries

​HTTP resource routes

​Continue

Example request

Returned result

Input fields

Validation and omitted values

Defaults when omitted

Output fields

Errors and retries

HTTP resource routes

Continue