@adkit/cli 1.12.22 → 1.12.23

package/dist/cli.js

@@ -4117,7 +4117,7 @@ var FLAG = {
   budgetDaily: "  --budget-daily <n>  Daily budget in account currency",
   cta: "  --cta <type>        sign_up, learn_more, shop_now, download, get_offer, contact_us, subscribe, get_quote, book_now, apply_now"
 };
-var RAW_PLATFORM_LABELS = { google: "Google", meta: "Meta", reddit: "Reddit", tiktok: "TikTok" };
+var RAW_PLATFORM_LABELS = { google: "Google", meta: "Meta", reddit: "Reddit", tiktok: "TikTok", x: "X" };
 function rawPlatformCommandLine(platform2) {
   return `Raw ${RAW_PLATFORM_LABELS[platform2] ?? platform2} API calls use the shared command: adkit manage platform-api-requests --platform ${platform2} ...`;
 }
@@ -5629,20 +5629,20 @@ Examples:
   "platform-api-requests": `adkit manage platform-api-requests \u2014 Send raw API requests to ad platforms
 
   Bypasses normalized AdKit entity validation, but still runs account and safety checks.
-  GET requests execute immediately. POST/PATCH/DELETE create drafts by default; add --publish to execute mutating requests immediately.
+  GET requests execute immediately. POST/PUT/PATCH/DELETE create drafts by default; add --publish to execute mutating requests immediately.
   Must be enabled in Agent Permissions first.
   Use this for unsupported native platform resources/workflows. Use platformOverrides instead when you only need raw fields on a supported normalized resource.
   Use the selected platform's official endpoint paths, field names, enum values, and resource shapes. Do not translate normalized AdKit field names into raw API payloads by guessing.
 
 Flags:
   --data <json>             Full request object (preferred for agents)
-  --platform <meta|google|tiktok|reddit> Target platform (required)
+  --platform <meta|google|tiktok|reddit|x> Target platform (required)
   --endpoint <path>          Relative API path (required)
-  --payload <json>           JSON body for POST/PATCH, query params for GET, omit for DELETE
-  --method <GET|POST|PATCH|DELETE>  HTTP method (default: POST)
+  --payload <json>           JSON body for POST/PUT/PATCH, query params for GET, omit for DELETE
+  --method <GET|POST|PUT|PATCH|DELETE>  HTTP method (default: POST)
   --request-description <text>  What this request does (required)
   --account <id>             Ad account ID (required)
-  --publish                  Execute POST/PATCH/DELETE immediately instead of creating a draft
+  --publish                  Execute POST/PUT/PATCH/DELETE immediately instead of creating a draft
 
 --data fields:
   platform, endpoint, payload, description, accountId, method, publish
@@ -5652,7 +5652,8 @@ Examples:
   adkit manage platform-api-requests --platform meta --endpoint "act_123/campaigns" --payload '{"name":"Test","objective":"OUTCOME_TRAFFIC","status":"PAUSED","special_ad_categories":[]}' --request-description "Create campaign" --account act_123 --publish
   adkit manage platform-api-requests --platform google --endpoint "customers/123/googleAds:mutate" --payload '{"mutateOperations":[...]}' --request-description "Pause ad" --account 123
   adkit manage platform-api-requests --platform tiktok --endpoint "campaign/get/" --method GET --payload '{"advertiser_id":"123"}' --request-description "List TikTok campaigns" --account 123
-  adkit manage platform-api-requests --platform reddit --endpoint "ad_accounts/a2_example/campaigns" --payload '{"name":"Test","objective":"TRAFFIC","configured_status":"PAUSED"}' --request-description "Create paused Reddit campaign" --account a2_example`.trim(),
+  adkit manage platform-api-requests --platform reddit --endpoint "ad_accounts/a2_example/campaigns" --payload '{"name":"Test","objective":"TRAFFIC","configured_status":"PAUSED"}' --request-description "Create paused Reddit campaign" --account a2_example
+  adkit manage platform-api-requests --platform x --endpoint "accounts/18ce54d4x5t/campaigns" --method GET --request-description "List X campaigns" --account 18ce54d4x5t`.trim(),
   manage: `adkit manage \u2014 Ad platform management
 
 Platforms:
@@ -5660,6 +5661,7 @@ Platforms:
   google              Google Ads
   tiktok              TikTok Ads
   reddit              Reddit Ads
+  x                   X Ads raw API access
   drafts              Manage drafts across platforms
   platform-api-requests  Send raw API requests (escape hatch)
 
@@ -5743,6 +5745,15 @@ General flags:
 ${FLAG.account}
 
 Run adkit manage reddit accounts --help for account setup.`.trim(),
+  x: `adkit manage x \u2014 X Ads raw API access
+
+X is currently exposed through Advanced Platform Access only.
+Use platform-api-requests with official X Ads API endpoint paths.
+
+${rawPlatformCommandLine("x")}
+
+Examples:
+  adkit manage platform-api-requests --platform x --endpoint "accounts/18ce54d4x5t/campaigns" --method GET --request-description "List X campaigns" --account 18ce54d4x5t`.trim(),
   drafts: `adkit manage drafts \u2014 Manage drafts
 
   list                List all drafts
@@ -6669,7 +6680,7 @@ function readRawRequestData(flags) {
   };
 }
 function readRawRequestFlags(flags) {
-  const platform2 = requireFlag(flags, "platform", "Required: --platform meta, google, tiktok, or reddit");
+  const platform2 = requireFlag(flags, "platform", "Required: --platform meta, google, tiktok, reddit, or x");
   const method = readRawRequestMethod(flags.method);
   const rawPayload = readRawRequestFlagPayload(flags);
   const payload = readRawRequestPayload({ method, payload: rawPayload, source: "flag" });
@@ -6704,12 +6715,12 @@ function readRawRequestString(input) {
   throw new CliError("MISSING_FLAG", `Missing required field: \`${input.field}\``, input.hint);
 }
 function readRawRequestPlatform(value) {
-  if (value === "meta" || value === "google" || value === "tiktok" || value === "reddit") return value;
-  throw new CliError("INVALID_VALUE", `Invalid platform: ${String(value)}`, "Use meta, google, tiktok, or reddit");
+  if (value === "meta" || value === "google" || value === "tiktok" || value === "reddit" || value === "x") return value;
+  throw new CliError("INVALID_VALUE", `Invalid platform: ${String(value)}`, "Use meta, google, tiktok, reddit, or x");
 }
 function readRawRequestMethod(value) {
   const method = typeof value === "string" ? value.toUpperCase() : "POST";
-  if (method !== "GET" && method !== "POST" && method !== "PATCH" && method !== "DELETE") throw new CliError("INVALID_VALUE", `Invalid method: ${method}`, "Use GET, POST, PATCH, or DELETE");
+  if (method !== "GET" && method !== "POST" && method !== "PUT" && method !== "PATCH" && method !== "DELETE") throw new CliError("INVALID_VALUE", `Invalid method: ${method}`, "Use GET, POST, PUT, PATCH, or DELETE");
   return method;
 }
 function readRawRequestPublish(input) {
@@ -6727,8 +6738,8 @@ function readRawRequestFlagPayload(flags) {
 }
 function readRawRequestPayload(input) {
   if (input.method !== "GET" && input.method !== "DELETE" && (input.payload === void 0 || input.payload === null)) {
-    if (input.source === "data") throw new CliError("MISSING_FLAG", "POST/PATCH requests require payload in --data", 'Include "payload": {"key":"value"}');
-    throw new CliError("MISSING_FLAG", "POST/PATCH requests require --payload", `Add --payload '{"key":"value"}'`);
+    if (input.source === "data") throw new CliError("MISSING_FLAG", "POST/PUT/PATCH requests require payload in --data", 'Include "payload": {"key":"value"}');
+    throw new CliError("MISSING_FLAG", "POST/PUT/PATCH requests require --payload", `Add --payload '{"key":"value"}'`);
   }
   if (input.method === "DELETE" && input.payload !== void 0 && input.payload !== null) throw new CliError("INVALID_VALUE", "DELETE requests do not support payload", "Put identifiers in the endpoint path");
   return input.payload ?? null;
@@ -6875,7 +6886,7 @@ async function main() {
         return;
       }
       const platform2 = manageTarget;
-      if (platform2 !== "meta" && platform2 !== "google" && platform2 !== "tiktok" && platform2 !== "reddit") throw new CliError("UNKNOWN_COMMAND", `Unknown platform: ${platform2}`, "Available: meta, google, tiktok, reddit, drafts, platform-api-requests");
+      if (platform2 !== "meta" && platform2 !== "google" && platform2 !== "tiktok" && platform2 !== "reddit" && platform2 !== "x") throw new CliError("UNKNOWN_COMMAND", `Unknown platform: ${platform2}`, "Available: meta, google, tiktok, reddit, x, drafts, platform-api-requests");
       const entity = args[2];
       const action = args[3];
       const restArgs = args.slice(4);
@@ -7502,7 +7513,8 @@ async function main() {
           default:
             throw new CliError("UNKNOWN_COMMAND", `Unknown entity: reddit ${entity}`, "Available: accounts, platform-api-requests");
         }
-      } else throw new CliError("UNKNOWN_COMMAND", "Unknown platform", "Available: meta, google, tiktok, reddit, drafts, platform-api-requests");
+      } else if (platform2 === "x") throw new CliError("UNKNOWN_COMMAND", `Unknown entity: x ${entity}`, "Available: platform-api-requests");
+      else throw new CliError("UNKNOWN_COMMAND", "Unknown platform", "Available: meta, google, tiktok, reddit, x, drafts, platform-api-requests");
       printResult(data, flags, emptyHint, detailEntity);
       return;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adkit/cli",
-  "version": "1.12.22",
+  "version": "1.12.23",
   "description": "The Ads CLI for AI agents — manage Meta & Google ad campaigns, browse the ad library, and generate creatives from your terminal.",
   "keywords": [
     "ads cli",