---
title: "Get Secret Share (Internal)"
method: GET
path: "/internal/secrets/{secret_name}/share"
tags: ["Control Plane - Internal"]
---

# Get Secret Share (Internal)

`GET /internal/secrets/{secret_name}/share`

## Request

- Base URL: `http://localhost:8000/api/v1`
- URL: `http://localhost:8000/api/v1/internal/secrets/{secret_name}/share`
- Auth: API key in header `X-Internal-API-Token`
- TypeScript: <https://skmtc.dev/deeptrail/apis/deepsecure-api-dual-service-architecture/docs/internal/secrets/:secret_name/share/get.ts> (a function with typed inputs; its response is checked against the schema)

Internal endpoint for the gateway to retrieve the control plane's share of a secret.
This is part of the split-key security architecture.

## Path parameters

- `secret_name` string, required

## Response `200`

Secret share retrieved successfully

- object
  - `share_1` string: Control plane's share of the secret
  - `target_base_url` string, nullable: Target URL for this secret (if configured)

## Other responses

- `401`: Invalid or missing internal API key
- `404`: Secret not found

---

[API](https://skmtc.dev/deeptrail/apis/deepsecure-api-dual-service-architecture.md) - [All operations](https://skmtc.dev/deeptrail/apis/deepsecure-api-dual-service-architecture/llms.txt) - [OpenAPI document](https://skmtc.dev/deeptrail/apis/deepsecure-api-dual-service-architecture/revisions/78627360c082?raw)