{"slug":"iid-googleapis-com","name":"iid.googleapis.com","host":"iid.googleapis.com","site":"https://googleapis.com","category":"communication","docsUrl":null,"sources":[{"kind":"archive","url":"https://firebase.google.com/docs/cloud-messaging/troubleshooting"}],"url":"https://www.okapi.bot/providers/iid-googleapis-com/","json":"https://www.okapi.bot/api/v1/providers/iid-googleapis-com.json","breakingChanges":[{"slug":"get-iid-info-stops-working","api":"iid-googleapis-com","title":"GET /iid/info stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":"2026-09-01","effectiveAt":"2027-09-29","scope":null,"calls":["GET /iid/info/*"],"method":"GET","path":"/iid/info/*","source":{"url":"https://firebase.google.com/docs/cloud-messaging/troubleshooting","kind":"archive"},"quote":"All the InstanceId server APIs and the device group feature are deprecated and will be decommissioned on September 29, 2027.","migration":"To validate a token, call POST /v1/projects/{project}/messages:send on fcm.googleapis.com with validate_only set to true; to read a token's topics, use the FCM topic subscription API (/v1/projects/{project}/registrations/{registration}/topicSubscriptions).","migrationChange":null,"needsDecision":null,"text":{"summary":"On September 29, 2027, the endpoint GET /iid/info/* will be decommissioned and calls to it will fail. This removal affects calls made to iid.googleapis.com under the InstanceId server APIs. After that day, requests to this endpoint will no longer work.","migration":"To validate a token, call POST /v1/projects/{project}/messages:send on fcm.googleapis.com with validate_only set to true. To read a token's topics, switch to the FCM topic subscription API at /v1/projects/{project}/registrations/{registration}/topicSubscriptions.","by":"writer"},"publishedAt":"2026-10-29T10:24:18.365Z","updatedAt":"2026-10-29T11:23:47.379Z","status":"upcoming","tone":"risk","url":"https://www.okapi.bot/providers/iid-googleapis-com/breaking-changes/get-iid-info-stops-working/"},{"slug":"post-iid-v1-batchadd-stops-working","api":"iid-googleapis-com","title":"POST /iid/v1:batchAdd stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":"2026-09-01","effectiveAt":"2027-09-29","scope":null,"calls":["POST /iid/v1:batchAdd"],"method":"POST","path":"/iid/v1:batchAdd","source":{"url":"https://firebase.google.com/docs/cloud-messaging/troubleshooting","kind":"archive"},"quote":"All the InstanceId server APIs and the device group feature are deprecated and will be decommissioned on September 29, 2027.","migration":"Use the FCM topic subscription API: POST /v1/projects/{project}/registrations/{registration}/topicSubscriptions on fcm.googleapis.com (or a Firebase Admin SDK release that calls it).","migrationChange":null,"needsDecision":null,"text":{"summary":"On September 29, 2027, POST /iid/v1:batchAdd will be decommissioned. Calls made to this endpoint after that day will fail. The change applies to all requests to POST /iid/v1:batchAdd.","migration":"Use the FCM topic subscription API instead by calling POST /v1/projects/{project}/registrations/{registration}/topicSubscriptions on fcm.googleapis.com, or upgrade to a Firebase Admin SDK release that calls it.","by":"writer"},"publishedAt":"2026-10-29T10:24:18.365Z","updatedAt":"2026-10-29T11:23:49.457Z","status":"upcoming","tone":"risk","url":"https://www.okapi.bot/providers/iid-googleapis-com/breaking-changes/post-iid-v1-batchadd-stops-working/"},{"slug":"post-iid-v1-batchimport-stops-working","api":"iid-googleapis-com","title":"POST /iid/v1:batchImport stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":"2026-09-01","effectiveAt":"2027-09-29","scope":null,"calls":["POST /iid/v1:batchImport"],"method":"POST","path":"/iid/v1:batchImport","source":{"url":"https://firebase.google.com/docs/cloud-messaging/troubleshooting","kind":"archive"},"quote":"All the InstanceId server APIs and the device group feature are deprecated and will be decommissioned on September 29, 2027.","migration":"Send to APNs tokens through Apple's APNs service, or integrate the FCM iOS SDK so that FCM registrations are created on the device.","migrationChange":null,"needsDecision":"Creating FCM registrations from APNs tokens on the server has no replacement: the app must adopt the FCM iOS SDK or send through APNs directly.","text":{"summary":"On September 29, 2027, the endpoint POST /iid/v1:batchImport will be decommissioned. Calls made to this endpoint will fail after that date. The change affects calls to the InstanceId server API for importing tokens.","migration":"Creating FCM registrations from APNs tokens on the server has no replacement. You must decide whether to send to APNs tokens directly through Apple's APNs service, or integrate the FCM iOS SDK so that registrations are created on the device.","by":"writer"},"publishedAt":"2026-10-29T10:24:18.365Z","updatedAt":"2026-10-29T11:23:51.629Z","status":"upcoming","tone":"risk","url":"https://www.okapi.bot/providers/iid-googleapis-com/breaking-changes/post-iid-v1-batchimport-stops-working/"},{"slug":"post-iid-v1-batchremove-stops-working","api":"iid-googleapis-com","title":"POST /iid/v1:batchRemove stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":"2026-09-01","effectiveAt":"2027-09-29","scope":null,"calls":["POST /iid/v1:batchRemove"],"method":"POST","path":"/iid/v1:batchRemove","source":{"url":"https://firebase.google.com/docs/cloud-messaging/troubleshooting","kind":"archive"},"quote":"All the InstanceId server APIs and the device group feature are deprecated and will be decommissioned on September 29, 2027.","migration":"Use the FCM topic subscription API: DELETE /v1/projects/{project}/registrations/{registration}/topicSubscriptions/{topic} on fcm.googleapis.com (or a Firebase Admin SDK release that calls it).","migrationChange":null,"needsDecision":null,"text":{"summary":"On September 29, 2027, the endpoint POST /iid/v1:batchRemove will be decommissioned and stop working. Calls to this endpoint will fail after that date. The change follows the deprecation of all InstanceId server APIs and the device group feature.","migration":"Use the FCM topic subscription API instead: DELETE /v1/projects/{project}/registrations/{registration}/topicSubscriptions/{topic} on fcm.googleapis.com, or a Firebase Admin SDK release that calls it.","by":"writer"},"publishedAt":"2026-10-29T10:24:18.365Z","updatedAt":"2026-10-29T11:23:48.585Z","status":"upcoming","tone":"risk","url":"https://www.okapi.bot/providers/iid-googleapis-com/breaking-changes/post-iid-v1-batchremove-stops-working/"},{"slug":"topic-subscription-on-iid-v1-rel-topics-stops-working","api":"iid-googleapis-com","title":"Topic subscription on /iid/v1/{}/rel/topics stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":"2026-09-01","effectiveAt":"2027-09-29","scope":null,"calls":["/iid/v1/*"],"method":null,"path":"/iid/v1/*","source":{"url":"https://firebase.google.com/docs/cloud-messaging/troubleshooting","kind":"archive"},"quote":"All the InstanceId server APIs and the device group feature are deprecated and will be decommissioned on September 29, 2027.","migration":"Use the FCM topic subscription API: POST /v1/projects/{project}/registrations/{registration}/topicSubscriptions on fcm.googleapis.com (or a Firebase Admin SDK release that calls it).","migrationChange":null,"needsDecision":null,"text":{"summary":"On September 29, 2027, endpoints matching /iid/v1/* will be decommissioned. After this date, calls to these Instance ID server APIs will fail. This change removes topic subscriptions and related features hosted on iid.googleapis.com.","migration":"Use the FCM topic subscription API instead by sending requests to POST /v1/projects/{project}/registrations/{registration}/topicSubscriptions on fcm.googleapis.com, or use a Firebase Admin SDK release that calls it.","by":"writer"},"publishedAt":"2026-10-29T10:24:18.365Z","updatedAt":"2026-10-29T11:23:50.175Z","status":"upcoming","tone":"risk","url":"https://www.okapi.bot/providers/iid-googleapis-com/breaking-changes/topic-subscription-on-iid-v1-rel-topics-stops-working/"}]}