---
title: "Get"
method: GET
path: "/external_storage_policies/{nameOrId}"
tags: ["externalStoragePolicies"]
---

# Get

`GET /external_storage_policies/{nameOrId}`

Returns an external storage policy by name or ID.

## Path parameters

- `nameOrId` string, required

## Query parameters

- `project` string

## Headers

- `Authorization` string, required

## Response `200`

Success response

- ExternalStoragePoliciesGetResponse200
  - `external_storage_policy` ExternalStoragePolicy, required — An S3-compatible destination that conversation artifacts are delivered to.
    - `id` string, required — The ID of the external storage policy.
    - `name` string, required — The name of the external storage policy. Agents reference the policy by this name.
    - `endpoint_url` string, required — The S3-compatible endpoint URL that artifacts are uploaded to.
    - `bucket` string, required — The bucket that artifacts are uploaded to.
    - `region` string, nullable, required — The region of the bucket. `null` when the endpoint doesn't require a region.
    - `key_prefix` string, nullable, required — Prefix prepended to every object key. `null` when objects are written at the bucket root.
    - `addressing_style` 'auto' | 'virtual' | 'path', required — How bucket names are addressed in requests to the endpoint.
    - `agent_count` integer, required — Number of agents currently referencing this external storage policy.

## Other responses

- `403` — Forbidden (resource belongs to a different organization)
- `404` — External storage policy not found
- `500` — Internal server error

---

[API](https://skmtc.net/phonic/apis/api-reference.md) · [All operations](https://skmtc.net/phonic/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/phonic/api-reference/revisions/7f8c81a5a990/schema)