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

Terminal Use Environments API

The Environments API from Terminal Use — 4 operation(s) for environments.

Terminal Use Environments API is one of 28 APIs that Terminal Use publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Environments. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 7 operations across 4 paths, and defines 12 schemas. It is described by OpenAPI 3.1.0, at version 0.1.0.

Requests are made against the base URL https://api.terminaluse.com.

7 operations 4 paths 12 schemas 1 DELETE4 GET1 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
0.1.0
Base URL
https://api.terminaluse.com
Resource Areas
1

Paths & Operations 7

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

Environments 7
GET
/agents/{namespace_slug}/{agent_name}/environments
List Environments
agents_environments_list 2 params → 200422
POST
/agents/{namespace_slug}/{agent_name}/environments
Create Environment
agents_environments_create 2 params body → 201422
DELETE
/agents/{namespace_slug}/{agent_name}/environments/{env_name}
Delete Environment
agents_environments_delete 3 params → 200422
GET
/agents/{namespace_slug}/{agent_name}/environments/{env_name}
Get Environment
agents_environments_retrieve 3 params → 200422
PUT
/agents/{namespace_slug}/{agent_name}/environments/{env_name}
Update Environment
agents_environments_update 3 params body → 200422
GET
/agents/{namespace_slug}/{agent_name}/environments/{env_name}/branches
List Branches for Environment
agents_environments_branches_list 3 params → 200422
GET
/agents/{namespace_slug}/{agent_name}/resolve-env
Resolve Environment for Branch
agents_resolve_env 3 params → 200422

Schemas 12

The contract defines 12 schemas that model the data the API accepts and returns. The most detailed are BranchResponse (10 properties), EnvResponse (7 properties), VersionSummary (6 properties), ValidationError (3 properties). Each schema is shown below with its type and property counts.

ResolveEnvResponse
object
Response for resolving which environment matches a branch.
2 properties 2 required
BranchResponse
object
Full branch details including current version.
10 properties 5 required
HTTPValidationError
object
1 property
ValidationError
object
3 properties 3 required
EnvListResponse
object
Response for listing environments.
2 properties 2 required
CreateEnvRequest
object
Request to create a new environment.
2 properties 2 required
VersionStatus
string
Status of a version in its lifecycle.
DeleteEnvResponse
object
Response after deleting an environment.
2 properties 2 required
UpdateEnvRequest
object
Request to update an environment (partial update).
1 property
EnvResponse
object
Full environment details.
7 properties 5 required
VersionSummary
object
Abbreviated version info for embedding in branch responses.
6 properties 4 required
BranchListResponse
object
Response for listing branches.
2 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

terminal-use-environments-api-openapi.yml Raw ↑

Other APIs Terminal Use publishes across the network.

Terminal Use Agent APIKeys API
Terminal Use Agent Task Tracker API
Terminal Use Agents API
Terminal Use API Keys API
Terminal Use Authentication API
Terminal Use Branch Events API
Terminal Use Branches API
Terminal Use Builds API
Terminal Use CLI Authentication API
Terminal Use Events API
Terminal Use Filesystems API
Terminal Use Groups API