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 Projects API

The Projects API from Julep — 2 operation(s) for projects.

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

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

This API exposes 7 operations across 2 paths, and defines 10 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.

7 operations 2 paths 10 schemas 1 DELETE2 GET1 PATCH2 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 Projects 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 7

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

Projects 7
GET
/projects
List Projects (paginated)
ProjectsRoute_list 5 params → 200
POST
/projects
Create a new Project
ProjectsRoute_create body → 201
POST
/projects/{id}
Create or update a Project
ProjectsRoute_createOrUpdate 1 param body → 200
PUT
/projects/{id}
Update an existing Project by id (overwrites existing values; use PATCH for merging instead)
ProjectsRoute_update 1 param body → 200
PATCH
/projects/{id}
Update an existing Project by id (merges with existing values)
ProjectsRoute_patch 1 param body → 200
DELETE
/projects/{id}
Delete Project by id
ProjectsRoute_delete 1 param → 202
GET
/projects/{id}
Get a Project by id
ProjectsRoute_get 1 param → 200

Schemas 10

The contract defines 10 schemas that model the data the API accepts and returns. The most detailed are Projects.Project (6 properties), Projects.CreateProjectRequest (3 properties), Projects.UpdateProjectRequest (3 properties), Common.ResourceDeletedResponse (3 properties). Each schema is shown below with its type and property counts.

Common.uuid
string
Common.ResourceDeletedResponse
object
3 properties 3 required
Projects.UpdateProjectRequest
object
Payload for updating a project
3 properties 1 required
Common.displayName
string
For display names Must be between 1 and 255 characters
Projects.CreateProjectRequest
object
Payload for creating a project
3 properties 1 required
Projects.PatchProjectRequest
object
Payload for patching a project
3 properties
Common.limit
integer
Limit the number of results
Projects.Project
object
Project model
6 properties 4 required
Common.canonicalName
string
For canonical names (machine-friendly identifiers) Must start with a letter and can only contain letters, numbers, and underscores
Common.offset
integer
Offset to apply to the results

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

julep-projects-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 Responses API
Julep Secrets API
Julep Sessions API
Julep Tasks API
Julep Users API