Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

TF-14885 Add default-project relationship to organization API docs #683

Open
wants to merge 15 commits into
base: main
Choose a base branch
from
+10 −1
Open

TF-14885 Add default-project relationship to organization API docs #683

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
15 commits
Select commit Hold shift + click to select a range
b41c2e7
Add default-project relationship to organization API docs
ker-an Jul 18, 2024
65077f8
Update API changelog
ker-an Jul 18, 2024
cc7368c
Update cost-estimation-enabled text
ker-an Jul 18, 2024
7f963f3
Update aggregated-commit-status-enabled text
ker-an Jul 18, 2024
7eb0729
Update owners-team-saml-role-id text
ker-an Jul 18, 2024
7852ce7
Update assessments-enforced text
ker-an Jul 18, 2024
d2b7b4d
Update allow-force-delete-workspaces text
ker-an Jul 18, 2024
c7f5ca3
Update default-project text
ker-an Jul 18, 2024
05177d4
Update changelog
ker-an Jul 18, 2024
5418184
Update default-execution-mode value type
ker-an Jul 18, 2024
5c77e19
Remove line from changelog that isn't needed
ker-an Jul 18, 2024
6bc8e67
Update API response
ker-an Jul 19, 2024
8800e1b
Update default-project description
ker-an Jul 19, 2024
946d181
Remove line about what happens if relationship ID is omitted
ker-an Jul 22, 2024
60e7d4d
Merge branch 'main' into ker-an/update-organization-api-docs
netramali Feb 26, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 3 additions & 1 deletion website/docs/cloud-docs/api-docs/changelog.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,8 +9,10 @@ description: >-

Keep track of changes to the API for HCP Terraform and Terraform Enterprise.

## 2024-11-19
## 2025-07-18
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@ker-an or @netramali Just a reminder we'll need to update this changelog before publishing

* Add `default-project` relationship to the [Organizations API](/terraform/cloud-docs/api-docs/organizations).

## 2024-02-26
- Clarify `tag-bindings` and `effective-tag-bindings` on [workspaces](/terraform/cloud-docs/api-docs/workspaces) and [projects](/terraform/cloud-docs/api-docs/projects)
- Adds new documentation for `PATCH`ing tag bindings on [projects](/terraform/cloud-docs/api-docs/projects) and [workspaces](/terraform/cloud-docs/api-docs/workspaces)

Expand Down
7 changes: 7 additions & 0 deletions website/docs/cloud-docs/api-docs/organizations.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -620,6 +620,7 @@ This PATCH endpoint requires a JSON object with the following properties as a re
| `data.attributes.allow-force-delete-workspaces` | boolean | false | Whether workspace administrators can [delete workspaces with resources under management](/terraform/cloud-docs/users-teams-organizations/organizations#general). If false, only organization owners may delete these workspaces. |
| `data.attributes.default-execution-mode` | boolean | `remote` | Which [execution mode](/terraform/cloud-docs/workspaces/settings#execution-mode) to use by default. Valid values are `remote`, `local`, and `agent`. |
| `data.attributes.default-agent-pool-id` | string | (previous value) | Required when `default-execution-mode` is set to `agent`. The ID of the agent pool belonging to the organization. Do _not_ specify this value if you set `execution-mode` to `remote` or `local`. |
| `data.relationships.default-project.data.id` | string | | Specifies the ID of the default project. If set to `null`, Terraform removes the organization's default project. You must have [owner permissions](/terraform/cloud-docs/users-teams-organizations/permissions#organization-owners) to update the default project. |

### Sample Payload

Expand Down Expand Up @@ -706,6 +707,12 @@ curl \
"default-agent-pool": {
"data": null
},
"default-project": {
"data": {
"type": "projects",
"id": "prj-1FzpQt4EyQDEqjCU"
}
}
"oauth-tokens": {
"links": {
"related": "/api/v2/organizations/hashicorp/oauth-tokens"
Expand Down