UpdateListingOwner

PATCH/api/v1/listings/{listing}/owners/{owner}

Update a listing ownership, such as when it expires.

Example request

US

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

Set OBLIQUE_API_KEY to your API key.

Europe

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

Set OBLIQUE_API_KEY to your API key.

Path parameters

• listingOwner.namestringrequired

  Assigned by Oblique. Name of the owner of the format listings/{listing}/owners/{owner}.

Query parameters

• updateMaskstring (field-mask)

  The list of fields to update.

• allowMissingboolean

  If set to true, and the listing owner is not found, a new listing owner will be created with the given name. If created in this way, update_mask is ignored.

Request body

• createTimestring (date-time)read-only

  Create and update timestamps.

• updateTimestring (date-time)read-only
• ownerstringrequired

  Set once, when the resource is created. The name of the owner. This can be a user, team, or group.

  Format: users/{user}, teams/{team}, groups/{group}

• managementManagement

  How this ownership is managed. Inherited from the parent listing: owners of Terraform-managed listings are themselves Terraform managed and can only be created, updated, or deleted through the Terraform provider; manage the parent listing to change this. Omitted from responses when the parent listing 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

200ListingOwner

• namestring

  Assigned by Oblique. Name of the owner of the format listings/{listing}/owners/{owner}.

• createTimestring (date-time)read-only

  Create and update timestamps.

• updateTimestring (date-time)read-only
• ownerstringrequired

  Set once, when the resource is created. The name of the owner. This can be a user, team, or group.

  Format: users/{user}, teams/{team}, groups/{group}

• managementManagement

  How this ownership is managed. Inherited from the parent listing: owners of Terraform-managed listings are themselves Terraform managed and can only be created, updated, or deleted through the Terraform provider; manage the parent listing to change this. Omitted from responses when the parent listing 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

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