---
title: "Get object store bucket status"
method: HEAD
path: "/api/v1/orgs/{orgId}/buckets/{name}"
tags: ["storage"]
---

# Get object store bucket status

`HEAD /api/v1/orgs/{orgId}/buckets/{name}`

## Request

- Base URL: `http://localhost:9090`
- URL: `http://localhost:9090/api/v1/orgs/{orgId}/buckets/{name}`
- Auth: HTTP bearer

Retrieves the status of the object store bucket given its name

## Path parameters

- `orgId` integer, required
- `name` string, required

## Query parameters

- `cloudType` 'amazon' | 'google' | 'azure', required
- `resourceGroup` string
- `storageAccount` string
- `location` string

## Headers

- `secretId` string
- `secretName` string

## Response `200`

Object store buckets exists

## Other responses

- `default`: Internal server error

## Changes

- **2021-01-28** `0caa9634f495`: 1 breaking
  - removed the enum value `alibaba` from the `query` request parameter `cloudType`
- **2021-01-22** `1d054e88f757`: 1 breaking
  - removed the enum value `oracle` from the `query` request parameter `cloudType`
- **2020-04-24** `5186ea64aa56`: 2 info
  - added the new enum value `alibaba` to the `query` request parameter `cloudType`
  - added the new enum value `oracle` to the `query` request parameter `cloudType`

[Operation history](https://skmtc.dev/banzaicloud/apis/pipeline-api/changes/api/v1/orgs/:orgId/buckets/:name/head.md)

---

[API](https://skmtc.dev/banzaicloud/apis/pipeline-api.md) · [All operations](https://skmtc.dev/banzaicloud/apis/pipeline-api/llms.txt) · [OpenAPI document](https://skmtc.dev/banzaicloud/apis/pipeline-api/revisions/a2e35c430378?raw)