Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Julep Secrets API

The Secrets API from Julep — 2 operation(s) for secrets.

Julep Secrets API is one of 12 APIs that Julep publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Secrets. The published artifact set on APIs.io includes an OpenAPI specification and authentication docs.

This API exposes 4 operations across 2 paths, and defines 7 schemas. It is described by OpenAPI 3.0.0, at version 1.0.0.

Requests are made against a single base URL, https://{serverEnv}.julep.ai/api.

4 operations 2 paths 7 schemas 1 DELETE1 GET1 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
1.0.0
Base URL
https://api.julep.ai/api
Authentication
API Key, API Key
Contact
License
Terms of Service
Resource Areas
1

Authentication & Security 2

Julep Secrets API declares 2 security schemes for authenticating requests. An API key is passed in the header as Authorization (ApiKeyAuth). An API key is passed in the header as X-Auth-Key (ApiKeyAuth_). By default, every request must be authenticated.

Paths & Operations 4

Across 2 paths, the API surfaces 4 operations — 1 DELETE, 1 GET, 1 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Secrets 4
GET
/secrets/{id}
List secrets (paginated)
DeveloperSecretsRoute_list 6 params → 200
POST
/secrets/{id}
Create a new secret
DeveloperSecretsRoute_create 1 param body → 201
PUT
/secrets/{id}/{child_id}
Update an existing secret by id (overwrites existing values)
DeveloperSecretsRoute_update 2 params body → 200
DELETE
/secrets/{id}/{child_id}
Delete a secret by id
DeveloperSecretsRoute_delete 2 params → 202

Schemas 7

The contract defines 7 schemas that model the data the API accepts and returns. The most detailed are Secrets.Secret (7 properties), Secrets.CreateSecretRequest (4 properties), Secrets.UpdateSecretRequest (4 properties), Common.ResourceDeletedResponse (3 properties). Each schema is shown below with its type and property counts.

Secrets.Secret
object
A secret that can be used in tasks and sessions
7 properties 5 required
Secrets.UpdateSecretRequest
object
4 properties 2 required
Secrets.CreateSecretRequest
object
4 properties 2 required
Common.ResourceDeletedResponse
object
3 properties 3 required
Common.uuid
string
Common.limit
integer
Limit the number of results
Common.offset
integer
Offset to apply to the results

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

julep-secrets-api-openapi.yml Raw ↑

Other APIs Julep publishes across the network.

Julep Agents API
Julep Docs API
Julep Embed API
Julep Executions API
Julep Files API
Julep Jobs API
Julep Projects API
Julep Responses API
Julep Sessions API
Julep Tasks API
Julep Users API