Projects and environments¶
Read access to projects (Infisical calls them workspaces in older APIs) and their environments,
plus createEnvironment for admins. All calls use the v1 API. Without an explicit project id
the config's projectId is used (CONFIG error when neither is set).
| Function | Endpoint (v1) | Notes |
|---|---|---|
listProjects({type, limit, offset}) |
GET /api/v1/projects |
projects the caller can see; returns projects + totalCount (ProjectList in TypeScript/Python, ProjectPage in Go, Rust and Java) |
getProject(projectId?) |
GET /api/v1/projects/{id} |
includes the environments; TypeScript takes { projectId } |
getProjectBySlug(slug) |
GET /api/v1/projects/slug/{slug} |
|
listEnvironments(projectId?) |
from getProject |
id, name, slug, position |
createEnvironment(name, slug, {projectId, position}) |
POST /api/v1/projects/{id}/environments |
admin permission; an existing slug → CONFLICT; viewer → PERMISSION_DENIED |
const { projects, totalCount } = await client.projects.listProjects({ limit: 50 });
const project = await client.projects.getProject(); // config projectId
const same = await client.projects.getProjectBySlug(project.slug);
const envs = await client.projects.listEnvironments();
const qa = await client.projects.createEnvironment("QA", "qa", { position: 4 });
use grow_infisical::ListProjectsOptions;
let page = client.list_projects(Some(&ListProjectsOptions { limit: Some(50), ..Default::default() })).await?;
let project = client.get_project(None).await?; // config project_id
let same = client.get_project_by_slug(&project.slug).await?;
let envs = client.list_environments(None).await?;
let qa = client.create_environment("QA", "qa", None).await?;
page, err := client.ListProjects(ctx, &infisical.ListProjectsOptions{Limit: 50})
project, err := client.GetProject(ctx, "") // config ProjectID
same, err := client.GetProjectBySlug(ctx, project.Slug)
envs, err := client.ListEnvironments(ctx, nil)
qa, err := client.CreateEnvironment(ctx, "QA", "qa", &infisical.CreateEnvironmentOptions{Position: 4})
ProjectPage page = client.listProjects(ListProjectsOptions.builder().limit(50).build());
Project project = client.getProject(null); // config projectId
Project same = client.getProjectBySlug(project.slug());
List<Environment> envs = client.listEnvironments(null);
Environment qa = client.createEnvironment("QA", "qa", null);