ListListingOwners

GET/api/v1/listings/{listing}/owners

Fetch the set of users, groups, or teams who are owners of this listing, and can manage and approve access to this listing. Admins can also manage and approve listings without being listed as owners.

Example request

US
Europe

curl \
  -H "Authorization: Bearer ${OBLIQUE_API_KEY}" \
  "https://us.oblique.security/api/v1/listings/{listing}/owners"

Set OBLIQUE_API_KEY to your API key.

curl \
  -H "Authorization: Bearer ${OBLIQUE_API_KEY}" \
  "https://eu.oblique.security/api/v1/listings/{listing}/owners"

Set OBLIQUE_API_KEY to your API key.

Path parameters

parentstringrequired
Format: listings/{listing}

Query parameters

pageSizeinteger (int32)
The maximum number of owners to return. This service may return fewer than this value.
pageTokenstring
A page token, received from a previous ListListingOwners call.

Response

200ListListingOwnersResponse

listingOwnersListingOwner[]
- 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.
nextPageTokenstring
A token, which can be sent as page_token to retrieve the next page.

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