---
title: "Get object storage key"
method: GET
path: "/bucket-keys/{filesystemKey}"
tags: ["Bucket Keys"]
---

# Get object storage key

`GET /bucket-keys/{filesystemKey}`

## Request

- Base URL: `https://cloud.laravel.com/api`
- URL: `https://cloud.laravel.com/api/bucket-keys/{filesystemKey}`
- Auth: HTTP bearer

Get a specific object storage key.

## Path parameters

- `filesystemKey` string, required

## Query parameters

- `include` string[]

## Response `200`

`FilesystemKeyResource`

- object
  - `data` FilesystemKeyResource, required
    - `id` string, required
    - `type` 'filesystemKeys', required
    - `attributes` object
      - `name` string, required
      - `permission` 'read_write' | 'read_only', required
      - `access_key_id` string, nullable, required
      - `access_key_secret` string, nullable, required
      - `created_at` string, date-time, nullable, required
    - `relationships` object
      - `filesystem` object
        - `data` FilesystemResourceIdentifier, required
          - `type` 'filesystems', required
          - `id` string, required
  - `included` FilesystemResource[]
    - `id` string, required
    - `type` 'filesystems', required
    - `attributes` object
      - `name` string, required
      - `type` 'cloudflare_r2', required
      - `status` 'creating' | 'updating' | 'available' | 'deleting' | 'deleted' | 'unknown', required
      - `visibility` 'private' | 'public', required
      - `jurisdiction` 'default' | 'eu' | 'us', required
      - `location_hint` 'automatic' | 'wnam' | 'enam' | 'weur' | 'eeur' | 'apac' | 'oc', required: Where Cloudflare should place an R2 bucket's data. Automatic lets Cloudflare choose, which it does from the caller's location rather than the customer's.
      - `endpoint` string, nullable, required
      - `url` string, nullable, required
      - `allowed_origins` unknown, required
      - `cors_settings` unknown, required
      - `created_at` string, date-time, nullable, required
    - `relationships` object
      - `keys` object
        - `data` FilesystemKeyResourceIdentifier[], required
          - `type` 'filesystemKeys', required
          - `id` string, required

## Other responses

- `403`: Authorization error
- `404`: Not found

---

[API](https://skmtc.dev/laravel/apis/laravel-cloud.md) - [All operations](https://skmtc.dev/laravel/apis/laravel-cloud/llms.txt) - [OpenAPI document](https://skmtc.dev/laravel/apis/laravel-cloud/revisions/af603f54ff33?raw)