bug: bidmodifiers toggle method returns error 55 on both sandbox AND production

[axisrow]

Bug

The bidmodifiers/toggle API method returns error 55 (Operation not found) on both sandbox and production Yandex Direct API. This means the method documented at https://yandex.ru/dev/direct/doc/ref-v5/bidmodifiers/toggle.html either does not exist or was removed/renamed.

Evidence

Production API

POST https://api.direct.yandex.com/json/v5/bidmodifiers
{"method":"toggle","params":{"BidModifierToggleItems":[{"CampaignId":58970381,"Type":"DEMOGRAPHICS_ADJUSTMENT","Enabled":"NO"}]}}

→ {"error":{"request_id":"8880852834319175308","error_code":55,"error_detail":"Invalid \"method\" value in a JSON request, or an invalid SOAPAction","error_string":"Operation not found"}}

Sandbox API

POST https://api-sandbox.direct.yandex.com/json/v5/bidmodifiers
{"method":"toggle","params":{"BidModifierToggleItems":[{"CampaignId":700010747,"Type":"DEMOGRAPHICS_ADJUSTMENT","Enabled":"NO"}]}}

→ {"error":{"request_id":"6945490746518830809","error_code":55,"error_detail":"Invalid \"method\" value in a JSON request, or an invalid SOAPAction","error_string":"Operation not found"}}

Other methods work fine (both environments)

• get → returns validation errors (expected — method exists)
• add → returns validation errors (expected — method exists)
• set → returns validation errors (expected — method exists)
• delete → returns validation errors (expected — method exists)
• toggle → error 55 "Operation not found" (method does NOT exist)

Impact

• Issue fix: bidmodifiers toggle uses wrong API method (set instead of toggle) #30 fix (PR fix: correct CLI bugs and test logic behind 5 falsely-skipped integration tests #29) cannot be validated — the toggle method it switches to does not exist in the API
• Issue test: re-record VCR cassette for bidmodifiers toggle after CLI fix #31 cassette re-recording is blocked
• The current set-based approach in bidmodifiers toggle is also broken (error 8000 — missing required BidModifier field), but the proposed toggle-based fix targets a non-existent API method

Possible explanations

1. The toggle method was removed from Yandex Direct API v5
2. The method was never available for all account types
3. The documentation is outdated or the method requires specific account permissions
4. The method name or endpoint structure differs from what's documented

Next steps

• Verify the API documentation is current — check if toggle method still appears in official docs
• Consider using set method with correct payload structure instead of toggle
• If toggle truly doesn't exist, close fix: bidmodifiers toggle uses wrong API method (set instead of toggle) #30 as "won't fix — API method does not exist" and revert the toggle command to use set with correct payload

Related

• fix: bidmodifiers toggle uses wrong API method (set instead of toggle) #30 — original toggle fix (assumes toggle method exists)
• test: re-record VCR cassette for bidmodifiers toggle after CLI fix #31 — cassette re-recording (blocked by this)
• PR fix: correct CLI bugs and test logic behind 5 falsely-skipped integration tests #29 — contains the toggle fix (may need revision)

[axisrow]

Resolution: official deprecation, not an implementation blocker

This issue is now classified as api-status:deprecated + api-status:not-in-wsdl.

Evidence:

• Official BidModifiers service docs list supported methods as add, delete, get, set and state that toggle is no longer supported since 2025-11-13: https://yandex.ru/dev/direct/doc/en/bidmodifiers/bidmodifiers
• Official API v5 changelog says the BidModifiers.toggle method is obsolete/no longer supported as of 2025-11-13: https://yandex.ru/dev/direct/doc/en/changelog
• Live WSDL for https://api.direct.yandex.com/v5/bidmodifiers?wsdl contains only add, delete, get, set.
• Existing issue evidence here and in test: re-record VCR cassette for bidmodifiers toggle after CLI fix #31 already showed prod/sandbox error 55 Operation not found for method: "toggle".

Decision:

• Do not implement or restore direct bidmodifiers toggle as canonical CLI coverage.
• Do not count bidmodifiers.toggle as a missing method for the 0.3.0 100% coverage gate.
• Keep supported coverage on bidmodifiers get/add/set/delete.
• Track the general audit policy in tests/API_ISSUE_AUDIT.md and test: roadmap for broader CLI/API coverage beyond current contract baseline #41/roadmap: 0.3.0 command coverage must reach 100% #55.

Closing as not planned because the upstream API operation is deprecated/unsupported, not because the CLI implementation is deferred.