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

The Secrets API from Terminal Use — 4 operation(s) for secrets.

Terminal Use Secrets 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 Secrets. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 5 operations across 4 paths, and defines 13 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.

5 operations 4 paths 13 schemas 1 DELETE3 GET1 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 5

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

Secrets 5
GET
/agents/{namespace_slug}/{agent_name}/environments/{env_name}/secrets
List Pending Secrets for Environment
agents_environments_secrets_list 4 params → 200422
PUT
/agents/{namespace_slug}/{agent_name}/environments/{env_name}/secrets
Set Secrets
agents_environments_secrets_set 3 params body → 200422
GET
/agents/{namespace_slug}/{agent_name}/environments/{env_name}/secrets/deployed
List Deployed Secrets for Environment
agents_environments_secrets_list_deployed 3 params → 200422
DELETE
/agents/{namespace_slug}/{agent_name}/environments/{env_name}/secrets/{key}
Delete Secret
agents_environments_secrets_delete 5 params → 200422
GET
/agents/{namespace_slug}/{agent_name}/secrets
List Secrets Across Environments
agents_secrets_list 3 params → 200422

Schemas 13

The contract defines 13 schemas that model the data the API accepts and returns. The most detailed are EnvVarResponse (7 properties), CrossEnvSecretResponse (4 properties), SetEnvVarResponse (4 properties), DeleteEnvVarResponse (4 properties). Each schema is shown below with its type and property counts.

EnvVarResponse
object
Response model for a single environment variable.
7 properties 4 required
HTTPValidationError
object
1 property
ValidationError
object
3 properties 3 required
EnvVarListResponse
object
Response for listing environment variables.
2 properties 1 required
SetEnvVarResponse
object
Response after setting environment variables.
4 properties 2 required
SetEnvVarRequest
object
Request to set environment variable(s). Matches design spec (deployment-addendum-rollback-and-envvars.md): { "secrets": { "OPENAIAPIKEY": {"value": "sk-xxx", "…
2 properties 1 required
CrossEnvSecretsListResponse
object
Cross-environment secrets view.
2 properties 2 required
EnvVarValue
object
Value with issecret flag for setting environment variables.
2 properties 1 required
DeployedSecretsResponse
object
Response for deployed secrets (from Version.secretssnapshot).
4 properties 3 required
DeleteEnvVarResponse
object
Response after deleting an environment variable.
4 properties 2 required
CrossEnvSecretResponse
object
A secret key across all environments.
4 properties 3 required
EnvSecretInfo
object
Secret presence in one environment.
4 properties 2 required
DeployedSecretKey
object
A key from deployed secrets snapshot.
2 properties 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

terminal-use-secrets-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 Environments API
Terminal Use Events API
Terminal Use Filesystems API