Update docs for v18.4.0 release

Author: gitlab-terraform-provider-bot

CHANGELOG.md

@@ -1,3 +1,19 @@
+## 18.4.0 (2025-09-18)
+
+### FEATURES (2 changes)
+
+- resource/gitlab_group_level_mr_approvals:  [Add group level merge request approvals resource](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/commit/4b8e3977ea9caaef1346ffc63f2a2da2bffadd49) by @heidi.berry ([merge request](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/2588)) 
+- resource/gitlab_project_external_status_check:  [Add new resource for project external status checks](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/commit/72fd42ed6093b3a87d1ed22d3d30d34f2194ef43) by @mness ([merge request](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/2633)) 
+
+### IMPROVEMENTS (1 change)
+
+- resource/gitlab_project_hook:  [Update docs to indicate which version of GitLab is required to use custom headers](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/commit/d61ae3b605a28b3535f2d28527e79941b62500e9) by @heidi.berry ([merge request](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/2663)) 
+
+### BUG FIXES (2 changes)
+
+- resource/gitlab_group_service_account:  [Wait for group service account users to be deleted during destroy](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/commit/5bccb8f83e4e2994af9e19812428c756ca577da8) by @heidi.berry ([merge request](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/2649)) 
+- resource/gitlab_group_share_group: [Add feature flag information for using custom roles](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/commit/70e1ed298d0f28430bb3d9138f2d49282fcd9b9e) by @heidi.berry ([merge request](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/2667))
+
 ## 18.3.0 (2025-08-22)
 
 ### FEATURES (3 changes)

docs/data-sources/branch.md

@@ -40,11 +40,11 @@ data "gitlab_branch" "foo" {
 ### Read-Only
 
 - `can_push` (Boolean) Bool, true if you can push to the branch.
-- `commit` (Set of Object) The commit associated with the branch ref. (see [below for nested schema](#nestedatt--commit))
+- `commit` (Attributes Set) The commit associated with the branch ref. (see [below for nested schema](#nestedatt--commit))
 - `default` (Boolean) Bool, true if branch is the default branch for the project.
 - `developer_can_merge` (Boolean) Bool, true if developer level access allows to merge branch.
 - `developer_can_push` (Boolean) Bool, true if developer level access allows git push.
-- `id` (String) The ID of this resource.
+- `id` (String) The ID of this datasource. In the format `<project:name>`.
 - `merged` (Boolean) Bool, true if the branch has been merged into its parent.
 - `protected` (Boolean) Bool, true if branch has branch protection.
 - `web_url` (String) The url of the created branch (https.)
@@ -54,14 +54,14 @@ data "gitlab_branch" "foo" {
 
 Read-Only:
 
-- `author_email` (String)
-- `author_name` (String)
-- `authored_date` (String)
-- `committed_date` (String)
-- `committer_email` (String)
-- `committer_name` (String)
-- `id` (String)
-- `message` (String)
-- `parent_ids` (Set of String)
-- `short_id` (String)
-- `title` (String)
+- `author_email` (String) The email of the author.
+- `author_name` (String) The name of the author.
+- `authored_date` (String) The date which the commit was authored (format: yyyy-MM-ddTHH:mm:ssZ).
+- `committed_date` (String) The date at which the commit was pushed (format: yyyy-MM-ddTHH:mm:ssZ).
+- `committer_email` (String) The email of the user that committed.
+- `committer_name` (String) The name of the user that committed.
+- `id` (String) The unique id assigned to the commit by Gitlab.
+- `message` (String) The commit message
+- `parent_ids` (Set of String) The id of the parents of the commit
+- `short_id` (String) The short id assigned to the commit by Gitlab.
+- `title` (String) The title of the commit

docs/data-sources/cluster_agent.md

@@ -3,13 +3,13 @@
 page_title: "gitlab_cluster_agent Data Source - terraform-provider-gitlab"
 subcategory: ""
 description: |-
-  The gitlab_cluster_agent data source allows to retrieve details about a GitLab Agent for Kubernetes.
+  The gitlab_cluster_agent data source retrieves details about a GitLab Agent for Kubernetes.
   Upstream API: GitLab REST API docs https://docs.gitlab.com/api/cluster_agents/
 ---
 
 # gitlab_cluster_agent (Data Source)
 
-The `gitlab_cluster_agent` data source allows to retrieve details about a GitLab Agent for Kubernetes.
+The `gitlab_cluster_agent` data source retrieves details about a GitLab Agent for Kubernetes.
 
 **Upstream API**: [GitLab REST API docs](https://docs.gitlab.com/api/cluster_agents/)
 
@@ -34,5 +34,5 @@ data "gitlab_cluster_agent" "example" {
 
 - `created_at` (String) The ISO8601 datetime when the agent was created.
 - `created_by_user_id` (Number) The ID of the user who created the agent.
-- `id` (String) The ID of this resource.
+- `id` (String) The ID of this data source. In the format <project:agent_id>
 - `name` (String) The Name of the agent.

docs/data-sources/current_user.md

@@ -31,5 +31,5 @@ data "gitlab_current_user" "example" {}
 - `id` (String) ID of the user.
 - `name` (String) Human-readable name of the user. Returns **** if the user is a project bot and the requester does not have permission to view the project.
 - `namespace_id` (String) Personal namespace of the user.
-- `public_email` (String) User’s public email.
+- `public_email` (String) User's public email.
 - `username` (String) Username of the user. Unique within this instance of GitLab.

docs/data-sources/group_hook.md

@@ -43,7 +43,7 @@ data "gitlab_group_hook" "example" {
 - `emoji_events` (Boolean) Invoke the hook for emoji events.
 - `enable_ssl_verification` (Boolean) Enable ssl verification when invoking the hook.
 - `group_id` (Number) The id of the group for the hook.
-- `id` (String) The ID of this resource.
+- `id` (String) The ID of this data source. In the format `<group:hook_id>`.
 - `issues_events` (Boolean) Invoke the hook for issues events.
 - `job_events` (Boolean) Invoke the hook for job events.
 - `merge_requests_events` (Boolean) Invoke the hook for merge requests.
@@ -54,6 +54,6 @@ data "gitlab_group_hook" "example" {
 - `releases_events` (Boolean) Invoke the hook for releases events.
 - `subgroup_events` (Boolean) Invoke the hook for subgroup events.
 - `tag_push_events` (Boolean) Invoke the hook for tag push events.
-- `token` (String) A token to present when invoking the hook. The token is not available for imported resources.
+- `token` (String, Deprecated) A token to present when invoking the hook. The token is not available in this datasource.
 - `url` (String) The url of the hook to invoke.
 - `wiki_page_events` (Boolean) Invoke the hook for wiki page events.

docs/data-sources/instance_deploy_keys.md

@@ -36,30 +36,30 @@ data "gitlab_instance_deploy_keys" "example" {
 
 ### Read-Only
 
-- `deploy_keys` (List of Object) The list of all deploy keys across all projects of the GitLab instance. (see [below for nested schema](#nestedatt--deploy_keys))
-- `id` (String) The ID of this resource.
+- `deploy_keys` (Attributes List) The list of all deploy keys across all projects of the GitLab instance. (see [below for nested schema](#nestedatt--deploy_keys))
+- `id` (String) The ID of this datasource. In the format `<public>`.
 
 <a id="nestedatt--deploy_keys"></a>
 ### Nested Schema for `deploy_keys`
 
 Read-Only:
 
-- `created_at` (String)
-- `fingerprint` (String)
-- `id` (Number)
-- `key` (String)
-- `projects_with_write_access` (List of Object) (see [below for nested schema](#nestedobjatt--deploy_keys--projects_with_write_access))
-- `title` (String)
+- `created_at` (String) The creation date of the deploy key. In RFC3339 format.
+- `fingerprint` (String) The fingerprint of the deploy key.
+- `id` (Number) The ID of the deploy key.
+- `key` (String) The deploy key.
+- `projects_with_write_access` (Attributes List) The list of projects that the deploy key has write access to. (see [below for nested schema](#nestedatt--deploy_keys--projects_with_write_access))
+- `title` (String) The title of the deploy key.
 
-<a id="nestedobjatt--deploy_keys--projects_with_write_access"></a>
+<a id="nestedatt--deploy_keys--projects_with_write_access"></a>
 ### Nested Schema for `deploy_keys.projects_with_write_access`
 
 Read-Only:
 
-- `created_at` (String)
-- `description` (String)
-- `id` (Number)
-- `name` (String)
-- `name_with_namespace` (String)
-- `path` (String)
-- `path_with_namespace` (String)
+- `created_at` (String) The creation date of the project. In RFC3339 format.
+- `description` (String) The description of the project.
+- `id` (Number) The ID of the project.
+- `name` (String) The name of the project.
+- `name_with_namespace` (String) The name of the project with namespace.
+- `path` (String) The path of the project.
+- `path_with_namespace` (String) The path of the project with namespace.

docs/data-sources/project_branches.md

@@ -34,37 +34,37 @@ data "gitlab_project_branches" "example" {
 
 ### Read-Only
 
-- `branches` (List of Object) The list of branches of the project, as defined below. (see [below for nested schema](#nestedatt--branches))
-- `id` (String) The ID of this resource.
+- `branches` (Attributes List) The list of branches of the project, as defined below. (see [below for nested schema](#nestedatt--branches))
+- `id` (String) The ID of this datasource. In the format `<project>`.
 
 <a id="nestedatt--branches"></a>
 ### Nested Schema for `branches`
 
 Read-Only:
 
-- `can_push` (Boolean)
-- `commit` (Set of Object) (see [below for nested schema](#nestedobjatt--branches--commit))
-- `default` (Boolean)
-- `developers_can_merge` (Boolean)
-- `developers_can_push` (Boolean)
-- `merged` (Boolean)
-- `name` (String)
-- `protected` (Boolean)
-- `web_url` (String)
-
-<a id="nestedobjatt--branches--commit"></a>
+- `can_push` (Boolean) Bool, true if you can push to the branch.
+- `commit` (Attributes Set) The commit associated with the branch ref. (see [below for nested schema](#nestedatt--branches--commit))
+- `default` (Boolean) Bool, true if branch is the default branch for the project.
+- `developers_can_merge` (Boolean) Bool, true if developer level access allows to merge branch.
+- `developers_can_push` (Boolean) Bool, true if developer level access allows git push.
+- `merged` (Boolean) Bool, true if the branch has been merged into its parent.
+- `name` (String) The name of the branch.
+- `protected` (Boolean) Bool, true if branch has branch protection.
+- `web_url` (String) URL that can be used to find the branch in a browser.
+
+<a id="nestedatt--branches--commit"></a>
 ### Nested Schema for `branches.commit`
 
 Read-Only:
 
-- `author_email` (String)
-- `author_name` (String)
-- `authored_date` (String)
-- `committed_date` (String)
-- `committer_email` (String)
-- `committer_name` (String)
-- `id` (String)
-- `message` (String)
-- `parent_ids` (Set of String)
-- `short_id` (String)
-- `title` (String)
+- `author_email` (String) The email of the author.
+- `author_name` (String) The name of the author.
+- `authored_date` (String) The date which the commit was authored (format: yyyy-MM-ddTHH:mm:ssZ).
+- `committed_date` (String) The date at which the commit was pushed (format: yyyy-MM-ddTHH:mm:ssZ).
+- `committer_email` (String) The email of the user that committed.
+- `committer_name` (String) The name of the user that committed.
+- `id` (String) The unique id assigned to the commit by Gitlab.
+- `message` (String) The commit message
+- `parent_ids` (Set of String) The id of the parents of the commit
+- `short_id` (String) The short id assigned to the commit by Gitlab.
+- `title` (String) The title of the commit

docs/data-sources/project_hook.md

@@ -3,13 +3,13 @@
 page_title: "gitlab_project_hook Data Source - terraform-provider-gitlab"
 subcategory: ""
 description: |-
-  The gitlab_project_hook data source allows to retrieve details about a hook in a project.
+  The gitlab_project_hook data source retrieves details about a hook in a project.
   Upstream API: GitLab REST API docs https://docs.gitlab.com/api/project_webhooks/#get-a-project-webhook
 ---
 
 # gitlab_project_hook (Data Source)
 
-The `gitlab_project_hook` data source allows to retrieve details about a hook in a project.
+The `gitlab_project_hook` data source retrieves details about a hook in a project.
 
 **Upstream API**: [GitLab REST API docs](https://docs.gitlab.com/api/project_webhooks/#get-a-project-webhook)
 
@@ -41,7 +41,7 @@ data "gitlab_project_hook" "example" {
 - `custom_webhook_template` (String) Set a custom webhook template.
 - `deployment_events` (Boolean) Invoke the hook for deployment events.
 - `enable_ssl_verification` (Boolean) Enable ssl verification when invoking the hook.
-- `id` (String) The ID of this resource.
+- `id` (String) The ID of this datasource. In the format `<project>:<hook-id>`.
 - `issues_events` (Boolean) Invoke the hook for issues events.
 - `job_events` (Boolean) Invoke the hook for job events.
 - `merge_requests_events` (Boolean) Invoke the hook for merge requests.
@@ -52,6 +52,6 @@ data "gitlab_project_hook" "example" {
 - `push_events_branch_filter` (String) Invoke the hook for push events on matching branches only.
 - `releases_events` (Boolean) Invoke the hook for releases events.
 - `tag_push_events` (Boolean) Invoke the hook for tag push events.
-- `token` (String) A token to present when invoking the hook. The token is not available for imported resources.
+- `token` (String, Sensitive, Deprecated) A token to present when invoking the hook. The token is not available in this datasource.
 - `url` (String) The url of the hook to invoke.
 - `wiki_page_events` (Boolean) Invoke the hook for wiki page events.

docs/data-sources/project_hooks.md

@@ -34,31 +34,31 @@ data "gitlab_project_hooks" "examples" {
 
 ### Read-Only
 
-- `hooks` (List of Object) The list of hooks. (see [below for nested schema](#nestedatt--hooks))
-- `id` (String) The ID of this resource.
+- `hooks` (Attributes List) The list of hooks. (see [below for nested schema](#nestedatt--hooks))
+- `id` (String) The ID of this datasource. In the format `<project>`.
 
 <a id="nestedatt--hooks"></a>
 ### Nested Schema for `hooks`
 
 Read-Only:
 
-- `confidential_issues_events` (Boolean)
-- `confidential_note_events` (Boolean)
-- `custom_webhook_template` (String)
-- `deployment_events` (Boolean)
-- `enable_ssl_verification` (Boolean)
-- `hook_id` (Number)
-- `issues_events` (Boolean)
-- `job_events` (Boolean)
-- `merge_requests_events` (Boolean)
-- `note_events` (Boolean)
-- `pipeline_events` (Boolean)
-- `project` (String)
-- `project_id` (Number)
-- `push_events` (Boolean)
-- `push_events_branch_filter` (String)
-- `releases_events` (Boolean)
-- `tag_push_events` (Boolean)
-- `token` (String)
-- `url` (String)
-- `wiki_page_events` (Boolean)
+- `confidential_issues_events` (Boolean) Invoke the hook for confidential issues events.
+- `confidential_note_events` (Boolean) Invoke the hook for confidential notes events.
+- `custom_webhook_template` (String) Set a custom webhook template.
+- `deployment_events` (Boolean) Invoke the hook for deployment events.
+- `enable_ssl_verification` (Boolean) Enable ssl verification when invoking the hook.
+- `hook_id` (Number) The id of the project hook.
+- `issues_events` (Boolean) Invoke the hook for issues events.
+- `job_events` (Boolean) Invoke the hook for job events.
+- `merge_requests_events` (Boolean) Invoke the hook for merge requests.
+- `note_events` (Boolean) Invoke the hook for notes events.
+- `pipeline_events` (Boolean) Invoke the hook for pipeline events.
+- `project` (String) The name or id of the project to add the hook to.
+- `project_id` (Number) The id of the project for the hook.
+- `push_events` (Boolean) Invoke the hook for push events.
+- `push_events_branch_filter` (String) Invoke the hook for push events on matching branches only.
+- `releases_events` (Boolean) Invoke the hook for releases events.
+- `tag_push_events` (Boolean) Invoke the hook for tag push events.
+- `token` (String, Sensitive, Deprecated) A token to present when invoking the hook. The token is not available in this datasource.
+- `url` (String) The url of the hook to invoke.
+- `wiki_page_events` (Boolean) Invoke the hook for wiki page events.

docs/data-sources/project_membership.md

@@ -3,16 +3,13 @@
 page_title: "gitlab_project_membership Data Source - terraform-provider-gitlab"
 subcategory: ""
 description: |-
-  The gitlab_project_membership data source allows to list and filter all members of a project specified by either its id or full path.
-  -> Note exactly one of project_id or full_path must be provided.
+  The gitlab_project_membership data source allows you to list and filter all members of a project.
   Upstream API: GitLab REST API docs https://docs.gitlab.com/api/members/#list-all-members-of-a-group-or-project
 ---
 
 # gitlab_project_membership (Data Source)
 
-The `gitlab_project_membership` data source allows to list and filter all members of a project specified by either its id or full path.
-
--> **Note** exactly one of project_id or full_path must be provided.
+The `gitlab_project_membership` data source allows you to list and filter all members of a project.
 
 **Upstream API**: [GitLab REST API docs](https://docs.gitlab.com/api/members/#list-all-members-of-a-group-or-project)
 
@@ -42,27 +39,28 @@ data "gitlab_project_membership" "example" {
 
 ### Optional
 
-- `full_path` (String) The full path of the project.
+- `full_path` (String, Deprecated) The full path of the project.
 - `inherited` (Boolean) Return all project members including members through ancestor groups
-- `project_id` (Number) The ID of the project.
+- `project` (String) The ID or full path of the project.
+- `project_id` (Number, Deprecated) The ID of the project.
 - `query` (String) A query string to search for members
 - `user_ids` (Set of Number) List of user ids to filter members by
 
 ### Read-Only
 
-- `id` (String) The ID of this resource.
-- `members` (List of Object) The list of project members. (see [below for nested schema](#nestedatt--members))
+- `id` (String) The ID of this datasource. In the format `<project:query-hash>` if query is set, otherwise `<project>`.
+- `members` (Attributes List) The list of project members. (see [below for nested schema](#nestedatt--members))
 
 <a id="nestedatt--members"></a>
 ### Nested Schema for `members`
 
 Read-Only:
 
-- `access_level` (String)
-- `avatar_url` (String)
-- `expires_at` (String)
-- `id` (Number)
-- `name` (String)
-- `state` (String)
-- `username` (String)
-- `web_url` (String)
+- `access_level` (String) The level of access to the group.
+- `avatar_url` (String) The avatar URL of the user.
+- `expires_at` (String) Expiration date for the group membership.
+- `id` (Number) The unique id assigned to the user by the gitlab server.
+- `name` (String) The name of the user.
+- `state` (String) Whether the user is active or blocked.
+- `username` (String) The username of the user.
+- `web_url` (String) User's website URL.