UpdateGroupOwner

PATCH/api/v1/groups/{group}/owners/{owner}

Update a group ownership, such as when it expires.

Example request

US
Europe

curl -X PATCH \
  -H "Authorization: Bearer ${OBLIQUE_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{ "owner": "string" }' \
  "https://us.oblique.security/api/v1/groups/{group}/owners/{owner}?updateMask=owner"

Set OBLIQUE_API_KEY to your API key.

curl -X PATCH \
  -H "Authorization: Bearer ${OBLIQUE_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{ "owner": "string" }' \
  "https://eu.oblique.security/api/v1/groups/{group}/owners/{owner}?updateMask=owner"

Set OBLIQUE_API_KEY to your API key.

Path parameters

groupOwner.namestringrequired
Assigned by Oblique. Name of the owner of the format groups/{group}/owners/{owner}.

Query parameters

allowMissingboolean
If set to true, and the group owner is not found, a new group owner will be created with the given name. If created in this way, update_mask is ignored.
updateMaskstring (field-mask)
The list of fields to update.

Request body

ownerstringrequired
The owner of the group.
updateTimestring (date-time)read-only
The time when this object was last updated.
createTimestring (date-time)read-only
The time when this object was created.
managementManagement
How this ownership is managed. Inherited from the parent group: owners of Terraform-managed groups are themselves Terraform managed and can only be created, updated, or deleted through the Terraform provider; manage the parent group to change this. Omitted from responses when the parent group is manually managed (the default).
- managerstring
  Allowed values: TERRAFORM
  How the API object is managed. Set automatically by the server based on the caller: Terraform clients produce TERRAFORM; for all other clients the management field is left unset on the response.
- repoUristring
  URI of the VCS repository that holds the Terraform configuration for this API object. Populated by the Oblique Terraform provider.
- repoDirstring
  Optionally, the subdirectory within repo_uri that holds the Terraform configuration for this API object. Populated by the Oblique Terraform provider.

Response

200GroupOwner

namestring
Assigned by Oblique. Name of the owner of the format groups/{group}/owners/{owner}.
ownerstringrequired
The owner of the group.
updateTimestring (date-time)read-only
The time when this object was last updated.
createTimestring (date-time)read-only
The time when this object was created.
managementManagement
How this ownership is managed. Inherited from the parent group: owners of Terraform-managed groups are themselves Terraform managed and can only be created, updated, or deleted through the Terraform provider; manage the parent group to change this. Omitted from responses when the parent group is manually managed (the default).
- managerstring
  Allowed values: TERRAFORM
  How the API object is managed. Set automatically by the server based on the caller: Terraform clients produce TERRAFORM; for all other clients the management field is left unset on the response.
- repoUristring
  URI of the VCS repository that holds the Terraform configuration for this API object. Populated by the Oblique Terraform provider.
- repoDirstring
  Optionally, the subdirectory within repo_uri that holds the Terraform configuration for this API object. Populated by the Oblique Terraform provider.

Errors

Status	Meaning
`400`	Malformed request
`401`	Missing or invalid API key
`403`	Not allowed for this API key
`404`	Not found
`429`	Too many requests
`500`	Internal server error