Skip to content

UpdateGroupOwner

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

Update a group ownership, such as when it expires.

Example request

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.

Path parameters

  • groupOwner.namestringrequired

    Assigned by Oblique.

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 resource 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 resource. Populated by the Oblique Terraform provider.

    • repoDirstring

      Optionally, the subdirectory within repo_uri that holds the Terraform configuration for this resource. Populated by the Oblique Terraform provider.

Response

200GroupOwner
  • namestring

    Assigned by Oblique.

  • 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 resource 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 resource. Populated by the Oblique Terraform provider.

    • repoDirstring

      Optionally, the subdirectory within repo_uri that holds the Terraform configuration for this resource. Populated by the Oblique Terraform provider.

Errors

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