Get secret API Reference

GET

/tenants/{tenant}/secrets/{name}

curl --request GET \
  --url https://api.kupe.cloud/api/v1/tenants/acme/secrets/database-creds \
  --header 'Authorization: <Authorization>'

Retrieve details for a specific managed secret, including its vault path, sync target configuration, and current sync status across clusters.

Authorizations

• BearerAuth

Parameters

Path Parameters

tenant

required

string

Tenant name

name

required

string

Secret name

Responses

200

Secret details

Media type application/json

object

createdAt

string

name

string

resourceVersion

string

secretPath

string

status

object

conditions

Array<object>

object

key

additional properties

phase

string

syncStatuses

Array<object>

object

key

additional properties

sync

Array<object>

object

cluster

string

namespace

string

secretName

string

Example

{
  "createdAt": "2026-03-10T09:15:00Z",
  "name": "database-creds",
  "resourceVersion": "582019",
  "secretPath": "services/database/credentials",
  "status": {
    "phase": "Synced"
  },
  "sync": [
    {
      "cluster": "production",
      "namespace": "app",
      "secretName": "db-credentials"
    }
  ]
}

Headers

ETag

string

Resource version for optimistic locking

400

Invalid name

Media type application/json

object

code

string

error

string

field

string

message

string

severity

string

Example ^generated

{
  "code": "example",
  "error": "example",
  "field": "example",
  "message": "example",
  "severity": "example"
}

401

Missing or invalid authentication

Media type application/json

object

code

string

error

string

field

string

message

string

severity

string

Example ^generated

{
  "code": "example",
  "error": "example",
  "field": "example",
  "message": "example",
  "severity": "example"
}

403

Not a member of this tenant

Media type application/json

object

code

string

error

string

field

string

message

string

severity

string

Example ^generated

{
  "code": "example",
  "error": "example",
  "field": "example",
  "message": "example",
  "severity": "example"
}

404

Secret not found

Media type application/json

object

code

string

error

string

field

string

message

string

severity

string

Example ^generated

{
  "code": "example",
  "error": "example",
  "field": "example",
  "message": "example",
  "severity": "example"
}

429

Rate limit exceeded

Media type application/json

object

code

string

error

string

field

string

message

string

severity

string

Example ^generated

{
  "code": "example",
  "error": "example",
  "field": "example",
  "message": "example",
  "severity": "example"
}