diff --git a/datadog/fwprovider/resource_datadog_restriction_policy.go b/datadog/fwprovider/resource_datadog_restriction_policy.go
index b5bf3738e4..047a146d13 100644
--- a/datadog/fwprovider/resource_datadog_restriction_policy.go
+++ b/datadog/fwprovider/resource_datadog_restriction_policy.go
@@ -73,7 +73,7 @@ func (r *RestrictionPolicyResource) Schema(_ context.Context, _ resource.SchemaR
 						},
 						"principals": schema.SetAttribute{
 							Required:    true,
-							Description: "An array of principals. A principal is a subject or group of subjects. Each principal is formatted as `type:id`. Supported types: `role` and `org`. The org ID can be obtained through the api/v2/users API.",
+							Description: "An array of principals. A principal is a subject or group of subjects. Each principal is formatted as `type:id`. Supported types: `role`, `team`, `user`, and `org`. Org ID can be obtained from the GET /api/v2/current_user API request. Find it in the `data.relationships.org.data.id` field.",
 							ElementType: types.StringType,
 						},
 					},
diff --git a/docs/resources/restriction_policy.md b/docs/resources/restriction_policy.md
index f315426cdb..b0bf897c75 100644
--- a/docs/resources/restriction_policy.md
+++ b/docs/resources/restriction_policy.md
@@ -51,7 +51,7 @@ Note: Dashboards support is in private beta. Reach out to your Datadog contact o
 
 Required:
 
-- `principals` (Set of String) An array of principals. A principal is a subject or group of subjects. Each principal is formatted as `type:id`. Supported types: `role` and `org`. The org ID can be obtained through the api/v2/users API.
+- `principals` (Set of String) An array of principals. A principal is a subject or group of subjects. Each principal is formatted as `type:id`. Supported types: `role`, `team`, `user`, and `org`. Org ID can be obtained from the [GET /api/v2/current_user API](https://app.datadoghq.com/api/v2/current_user) request. Find it in the `data.relationships.org.data.id` field.
 - `relation` (String) The role/level of access. See this page for more details https://docs.datadoghq.com/api/latest/restriction-policies/#supported-relations-for-resources
 
 ## Import