Esri · dixonyant · Jun 18, 2026 · Jun 18, 2026 · Jun 23, 2026 · Jun 23, 2026
diff --git a/.changeset/cold-teams-sit.md b/.changeset/cold-teams-sit.md
@@ -0,0 +1,45 @@
+---
+"@esri/arcgis-rest-basemap-sessions": major
+"@esri/arcgis-rest-developer-credentials": major
+"@esri/arcgis-rest-elevation": major
+"@esri/arcgis-rest-feature-service": major
+"@esri/arcgis-rest-geocoding": major
+"@esri/arcgis-rest-places": major
+"@esri/arcgis-rest-portal": major
+"@esri/arcgis-rest-request": major
+---
+
+remove support for rawResponse and update packages to new IRequestOptions shape
+
+### Summary
+
+This change drops support for `rawResponse` from all packages, updates all packages to use the new `IRequestOptions` shape, and adds support for raw requests with new methods.
+
+- `rawResponse` support removed from REST JS
+- fetch methods now return JSON only. Non-JSON data can be fetched using `rawRequest()` or new wrapper methods that implement it.
+- added `queryFeaturesRaw()` and `getItemDataRaw()`
+- converted all `httpMethod` instances to the new `fetchOptions.method`
+
+### Why these changes were made
+
+- REST JS methods are being moved to return JSON only in most cases.
+- Generic types will be easier to implement and improve our TypeScript commitment.
+- Improve API surface area and our testing landscape.
+- Separate default function from more advanced uses.
+
+### Breaking Changes
+
+- `getFeature()` no longer supports raw response.
+- `queryFeatures()` can no longer be used to query features as pbf with `f=pbf`.
+- `bulkGeocode()` no longer supports raw response.
+- `geocode()` no longer supports raw response.
+- `getItemData()` no longer supports raw, file, or binary responses, use getItemDataRaw()instead.
+  deprecated IItemDataOptions since we don't support the file property in getItemData() anymore. Use getItemDataRaw() to get the native response instead.
+- `getItemInfo()` no longer supports rawResponse as an option and uses rawRequest() as default behavior.
+- `getItemResource()` no longer supports rawResponse as an option and uses rawRequest() as default behavior.
+
+### Migration guide
+
+- To get a raw response, construct your own request and use `rawRequest()` to fetch a native response.
+- For querying features as `pbf`, use `queryFeaturesRaw()` and supply `f=pbf` in the query options.
+- To manually set an HTTP method, supply `fetchOptions.method` in IRequestOptions instead of top-level `httpMethod`.
diff --git a/packages/arcgis-rest-basemap-sessions/src/utils/startNewSession.ts b/packages/arcgis-rest-basemap-sessions/src/utils/startNewSession.ts
@@ -23,7 +23,7 @@ export function startNewSession({
   duration = DEFAULT_DURATION
 }: IRequestNewSessionParams): Promise<IStartSessionResponse> {
   return request(startSessionUrl, {
-    httpMethod: "GET",
+    fetchOptions: { method: "GET" },
     authentication: authentication,
     params: { styleFamily, durationSeconds: duration }
   });

diff --git a/packages/arcgis-rest-developer-credentials/src/createApiKey.ts b/packages/arcgis-rest-developer-credentials/src/createApiKey.ts
@@ -62,7 +62,10 @@ import { getRegisteredAppInfo } from "./shared/getRegisteredAppInfo.js";
 export async function createApiKey(
   requestOptions: ICreateApiKeyOptions
 ): Promise<IApiKeyResponse> {
-  requestOptions.httpMethod = "POST";
+  requestOptions.fetchOptions = {
+    ...requestOptions.fetchOptions,
+    method: "POST"
+  };
 
   // filter param buckets:
   const baseRequestOptions = extractBaseRequestOptions(requestOptions); // snapshot of basic IRequestOptions before customized params being built into it

diff --git a/packages/arcgis-rest-developer-credentials/src/createOAuthApp.ts b/packages/arcgis-rest-developer-credentials/src/createOAuthApp.ts
@@ -48,7 +48,10 @@ import { ICreateOAuthAppOption, IOAuthApp } from "./shared/types/oAuthType.js";
 export async function createOAuthApp(
   requestOptions: ICreateOAuthAppOption
 ): Promise<IOAuthApp> {
-  requestOptions.httpMethod = "POST";
+  requestOptions.fetchOptions = {
+    ...requestOptions.fetchOptions,
+    method: "POST"
+  };
 
   // filter param buckets:
 

diff --git a/packages/arcgis-rest-developer-credentials/src/shared/getRegisteredAppInfo.ts b/packages/arcgis-rest-developer-credentials/src/shared/getRegisteredAppInfo.ts
@@ -42,7 +42,10 @@ export async function getRegisteredAppInfo(
   const url =
     getPortalUrl(requestOptions) +
     `/content/users/${userName}/items/${requestOptions.itemId}/registeredAppInfo`;
-  requestOptions.httpMethod = "POST";
+  requestOptions.fetchOptions = {
+    ...requestOptions.fetchOptions,
+    method: "POST"
+  };
 
   const registeredAppResponse: IRegisteredAppResponse = await request(url, {
     ...requestOptions,

diff --git a/packages/arcgis-rest-developer-credentials/src/shared/helpers.ts b/packages/arcgis-rest-developer-credentials/src/shared/helpers.ts
@@ -87,15 +87,9 @@ export function extractBaseRequestOptions<T extends IRequestOptions>(
   options: T
 ): Partial<IRequestOptions> {
   const requestOptionsProperties: Array<keyof T> = [
-    "credentials",
-    "headers",
-    "hideToken",
-    "httpMethod",
-    "maxUrlLength",
     "portal",
-    "rawResponse",
-    "signal",
-    "suppressWarnings"
+    "requestFlags",
+    "fetchOptions"
   ];
 
   return filterKeys(options, requestOptionsProperties);

diff --git a/packages/arcgis-rest-developer-credentials/src/shared/unregisterApp.ts b/packages/arcgis-rest-developer-credentials/src/shared/unregisterApp.ts
@@ -36,7 +36,10 @@ import { request } from "@esri/arcgis-rest-request";
 export async function unregisterApp(
   requestOptions: IUnregisterAppOptions
 ): Promise<IUnregisterAppResponse> {
-  requestOptions.httpMethod = "POST";
+  requestOptions.fetchOptions = {
+    ...requestOptions.fetchOptions,
+    method: "POST"
+  };
 
   // get app
   const baseRequestOptions = extractBaseRequestOptions(requestOptions);

diff --git a/packages/arcgis-rest-developer-credentials/src/updateApiKey.ts b/packages/arcgis-rest-developer-credentials/src/updateApiKey.ts
@@ -63,7 +63,10 @@ import {
 export async function updateApiKey(
   requestOptions: IUpdateApiKeyOptions
 ): Promise<IApiKeyResponse> {
-  requestOptions.httpMethod = "POST";
+  requestOptions.fetchOptions = {
+    ...requestOptions.fetchOptions,
+    method: "POST"
+  };
   const baseRequestOptions = extractBaseRequestOptions(requestOptions); // get base requestOptions snapshot
 
   /**

diff --git a/packages/arcgis-rest-developer-credentials/src/updateOAuthApp.ts b/packages/arcgis-rest-developer-credentials/src/updateOAuthApp.ts
@@ -50,7 +50,10 @@ import { getRegisteredAppInfo } from "./shared/getRegisteredAppInfo.js";
 export async function updateOAuthApp(
   requestOptions: IUpdateOAuthOptions
 ): Promise<IOAuthApp> {
-  requestOptions.httpMethod = "POST";
+  requestOptions.fetchOptions = {
+    ...requestOptions.fetchOptions,
+    method: "POST"
+  };
 
   // get app
   const baseRequestOptions = extractBaseRequestOptions(requestOptions); // get base requestOptions snapshot

diff --git a/packages/arcgis-rest-developer-credentials/test/getApiKey.test.ts b/packages/arcgis-rest-developer-credentials/test/getApiKey.test.ts
@@ -211,7 +211,7 @@ describe("getApiKey()", () => {
     const apiKeyResponse = await getApiKey({
       itemId: "cddcacee5848488bb981e6c6ff91ab79",
       authentication: authOnline,
-      httpMethod: "GET"
+      fetchOptions: { method: "GET" }
     });
 
     // verify first fetch

diff --git a/packages/arcgis-rest-developer-credentials/test/shared/getRegisteredAppInfo.test.ts b/packages/arcgis-rest-developer-credentials/test/shared/getRegisteredAppInfo.test.ts
@@ -151,7 +151,7 @@ describe("registerApp()", () => {
     const requestOptions: IGetAppInfoOptions = {
       itemId: "fake-itemID",
       authentication: authOnline,
-      httpMethod: "GET"
+      fetchOptions: { method: "GET" }
     };
 
     const appResponse = await getRegisteredAppInfo(requestOptions);

diff --git a/packages/arcgis-rest-developer-credentials/test/shared/registerApp.test.ts b/packages/arcgis-rest-developer-credentials/test/shared/registerApp.test.ts
@@ -170,7 +170,7 @@ describe("registerApp()", () => {
       httpReferrers: ["https://www.esri.com/en-us/home"],
       privileges: [],
       authentication: authOnline,
-      httpMethod: "GET"
+      fetchOptions: { method: "GET" }
     };
 
     const appResponse = await registerApp(requestOptions);

diff --git a/packages/arcgis-rest-elevation/src/findElevationAtManyPoints.ts b/packages/arcgis-rest-elevation/src/findElevationAtManyPoints.ts
@@ -23,11 +23,18 @@ type successResponse =
  */
 export interface IFindElevationAtManyPointsResponse extends successResponse {}
 
+type IRequestOptionsWithoutHttpMethod = Omit<
+  IRequestOptions,
+  "fetchOptions"
+> & {
+  fetchOptions?: Omit<RequestInit, "method">;
+};
+
 /**
  * Options for {@linkcode findElevationAtPoint}.
  */
 export interface IFindElevationAtManyPointsOptions
-  extends Omit<IRequestOptions, "httpMethod" | "f">,
+  extends IRequestOptionsWithoutHttpMethod,
     queryParams {}
 
 /**

diff --git a/packages/arcgis-rest-elevation/src/findElevationAtPoint.ts b/packages/arcgis-rest-elevation/src/findElevationAtPoint.ts
@@ -23,11 +23,18 @@ type successResponse =
  */
 export interface IFindElevationAtPointResponse extends successResponse {}
 
+type IRequestOptionsWithoutHttpMethod = Omit<
+  IRequestOptions,
+  "fetchOptions"
+> & {
+  fetchOptions?: Omit<RequestInit, "method">;
+};
+
 /**
  * Options for {@linkcode findElevationAtPoint}.
  */
 export interface IFindElevationAtPointOptions
-  extends Omit<IRequestOptions, "httpMethod" | "f">,
+  extends IRequestOptionsWithoutHttpMethod,
     queryParams {}
 
 /**
@@ -68,7 +75,10 @@ export function findElevationAtPoint(
   return (
     request(`${baseUrl}/elevation/at-point`, {
       ...options,
-      httpMethod: "GET"
+      fetchOptions: {
+        ...options.fetchOptions,
+        method: "GET"
+      }
     }) as Promise<successResponse>
   ).then((response) => {
     const r: IFindElevationAtPointResponse = {

diff --git a/packages/arcgis-rest-feature-service/src/getAttachments.ts b/packages/arcgis-rest-feature-service/src/getAttachments.ts
@@ -44,8 +44,11 @@ export function getAttachments(
   requestOptions: IGetAttachmentsOptions
 ): Promise<{ attachmentInfos: IAttachmentInfo[] }> {
   const options: IGetAttachmentsOptions = {
-    httpMethod: "GET",
-    ...requestOptions
+    ...requestOptions,
+    fetchOptions: {
+      method: "GET",
+      ...requestOptions.fetchOptions
+    }
   };
 
   // pass through