Secrets

Create or update a secret

post

Save a secret for data sources/destinations usage

Authorizations

AuthorizationstringRequired

Your ByteNite access token

Body

secretKeystringRequired

Your data source's secret key.

Example: wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY

Responses

200

A successful response.

400

Returned when the users sends a malformed request.

401

Returned when the user is not authenticated.

403

Returned when the user does not have permission to access the resource.

404

Returned when the resource does not exist.

500

Returned when an error on the server occurred.

503

Returned when the resource is temporarily unavailable.

default

An unexpected error response.

post

/secrets

POST /v1/auth/secrets HTTP/1.1
Host: api.bytenite.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 242

{
  "secret": {
    "id": "s3-secret",
    "secretType": "s3",
    "expiresAt": "2025-12-29T18:02:27.140Z",
    "accessKey": "AKIAIOSFODNN7EXAMPLE",
    "params": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "name": "My S3 Secret"
  },
  "secretKey": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY"
}

{
  "ok": false,
  "requestId": "xyz-123",
  "message": "Request  failed",
  "error": {
    "code": 404,
    "message": "Not Found",
    "description": "The requested resource was not found"
  }
}

List available secrets

get

List available secrets

Authorizations

AuthorizationstringRequired

Your ByteNite access token

Query parameters

secretTypestringOptional

The type of the secret

Responses

200

A successful response.

400

Returned when the users sends a malformed request.

401

Returned when the user is not authenticated.

403

Returned when the user does not have permission to access the resource.

404

Returned when the resource does not exist.

500

Returned when an error on the server occurred.

503

Returned when the resource is temporarily unavailable.

default

An unexpected error response.

get

/secrets

GET /v1/auth/secrets HTTP/1.1
Host: api.bytenite.com
Authorization: YOUR_API_KEY
Accept: */*

{
  "secrets": [
    {
      "id": "s3-secret",
      "secretType": "s3",
      "expiresAt": "2025-12-29T18:02:27.140Z",
      "accessKey": "AKIAIOSFODNN7EXAMPLE",
      "params": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "name": "My S3 Secret"
    }
  ]
}

Remove a secret

delete

Remove a secret

Authorizations

AuthorizationstringRequired

Your ByteNite access token

Path parameters

secretTypestringRequired

The type of the secret

idstringRequired

The ID of the secret

Responses

200

A successful response.

400

Returned when the users sends a malformed request.

401

Returned when the user is not authenticated.

403

Returned when the user does not have permission to access the resource.

404

Returned when the resource does not exist.

500

Returned when an error on the server occurred.

503

Returned when the resource is temporarily unavailable.

default

An unexpected error response.

delete

/secrets/{secretType}/{id}

DELETE /v1/auth/secrets/{secretType}/{id} HTTP/1.1
Host: api.bytenite.com
Authorization: YOUR_API_KEY
Accept: */*

{
  "ok": false,
  "requestId": "xyz-123",
  "message": "Request  failed",
  "error": {
    "code": 404,
    "message": "Not Found",
    "description": "The requested resource was not found"
  }
}

PreviousAPI Keys NextUser

Last updated 7 months ago

Was this helpful?