feat(actions): allow getting metadata of organizations from user grants (#7782)

* feat(actions): allow getting metadata of (other) organizations from user grants

* docs add action example

docs/docs/apis/actions/code-examples.mdx

@@ -68,6 +68,19 @@ https://github.com/zitadel/actions/blob/main/examples/custom_roles.js
 
 </details>
 
+### Custom role mapping including org metadata in claims
+
+There's even a possibility to use the metadata of organizations the user is granted to
+
+<details open="">
+<summary>Code example</summary>
+
+```js reference
+https://github.com/zitadel/actions/blob/main/examples/custom_roles_org_metadata.js
+```
+
+</details>
+
 ## Customize SAML response
 
 Append attributes returned on SAML requests.

docs/docs/apis/actions/objects.md

@@ -210,3 +210,5 @@ This object represents a list of user grant stored in ZITADEL.
     The name of the organization, where the user was granted
   - `projectId` *string*
   - `projectName` *string*
+  - `getOrgMetadata()` [*metadataResult*](#metadata-result)  
+    Get the metadata of the organization where the user was granted