diff --git a/docs/tutorials/journey.md b/docs/tutorials/journey.md
index 249507ddf0..126bb5ae0d 100644
--- a/docs/tutorials/journey.md
+++ b/docs/tutorials/journey.md
@@ -48,7 +48,6 @@ that implements the `OAuthApi` type, it's now working in the frontend too.
 ```ts
 const spotifyAuthApiRef = createApiRef<OAuthApi>({
   id: 'core.auth.spotify',
-  description: 'Provides authentication towards Spotify APIs',
 });
 ```
 
diff --git a/docs/tutorials/using-backstage-proxy-within-plugin.md b/docs/tutorials/using-backstage-proxy-within-plugin.md
index b0c6bef8ef..771aa7a652 100644
--- a/docs/tutorials/using-backstage-proxy-within-plugin.md
+++ b/docs/tutorials/using-backstage-proxy-within-plugin.md
@@ -99,7 +99,6 @@ export interface MyAwesomeApi {
 
 export const myAwesomeApiRef = createApiRef<MyAwesomeApi>({
   id: 'plugin.my-awesome-api.service',
-  description: 'Example API definition',
 });
 ```