openapi: 3.1.0 info: title: LangWatch Agents Secrets API version: 1.0.0 description: LangWatch openapi spec servers: - url: https://app.langwatch.ai security: - project_api_key: [] tags: - name: Secrets paths: /api/secrets: get: responses: '200': description: Success content: application/json: schema: type: array items: type: object properties: id: type: string projectId: type: string name: type: string createdAt: type: string updatedAt: type: string required: - id - projectId - name - createdAt - updatedAt '400': description: Bad Request content: application/json: schema: type: object properties: error: type: string message: type: string required: - error '401': description: Unauthorized content: application/json: schema: type: object properties: error: type: string message: type: string required: - error '422': description: Unprocessable Entity content: application/json: schema: type: object properties: error: type: string message: type: string required: - error '500': description: Internal Server Error content: application/json: schema: type: object properties: error: type: string message: type: string required: - error operationId: getApiSecrets parameters: [] description: List all secrets for the project (values are never returned) tags: - Secrets post: responses: '201': description: Secret created content: application/json: schema: type: object properties: id: type: string projectId: type: string name: type: string createdAt: type: string updatedAt: type: string required: - id - projectId - name - createdAt - updatedAt '400': description: Bad Request content: application/json: schema: type: object properties: error: type: string message: type: string required: - error '401': description: Unauthorized content: application/json: schema: type: object properties: error: type: string message: type: string required: - error '409': description: Secret with this name already exists content: application/json: schema: type: object properties: error: type: string message: type: string required: - error '422': description: Unprocessable Entity content: application/json: schema: type: object properties: error: type: string message: type: string required: - error '500': description: Internal Server Error content: application/json: schema: type: object properties: error: type: string message: type: string required: - error operationId: postApiSecrets parameters: [] description: Create a new project secret. The value is encrypted at rest and never returned. requestBody: content: application/json: schema: type: object properties: name: type: string pattern: ^[A-Z][A-Z0-9_]*$ minLength: 1 value: type: string minLength: 1 maxLength: 10000 required: - name - value tags: - Secrets /api/secrets/{id}: get: responses: '200': description: Success content: application/json: schema: type: object properties: id: type: string projectId: type: string name: type: string createdAt: type: string updatedAt: type: string required: - id - projectId - name - createdAt - updatedAt '400': description: Bad Request content: application/json: schema: type: object properties: error: type: string message: type: string required: - error '401': description: Unauthorized content: application/json: schema: type: object properties: error: type: string message: type: string required: - error '404': description: Secret not found content: application/json: schema: type: object properties: error: type: string message: type: string required: - error '422': description: Unprocessable Entity content: application/json: schema: type: object properties: error: type: string message: type: string required: - error '500': description: Internal Server Error content: application/json: schema: type: object properties: error: type: string message: type: string required: - error operationId: getApiSecretsById parameters: - schema: type: string in: path name: id required: true description: Get a secret by its ID (value is never returned) tags: - Secrets put: responses: '200': description: Secret updated content: application/json: schema: type: object properties: id: type: string projectId: type: string name: type: string createdAt: type: string updatedAt: type: string required: - id - projectId - name - createdAt - updatedAt '400': description: Bad Request content: application/json: schema: type: object properties: error: type: string message: type: string required: - error '401': description: Unauthorized content: application/json: schema: type: object properties: error: type: string message: type: string required: - error '404': description: Secret not found content: application/json: schema: type: object properties: error: type: string message: type: string required: - error '422': description: Unprocessable Entity content: application/json: schema: type: object properties: error: type: string message: type: string required: - error '500': description: Internal Server Error content: application/json: schema: type: object properties: error: type: string message: type: string required: - error operationId: putApiSecretsById parameters: - schema: type: string in: path name: id required: true description: Update a secret's value requestBody: content: application/json: schema: type: object properties: value: type: string minLength: 1 maxLength: 10000 required: - value tags: - Secrets delete: responses: '200': description: Secret deleted content: application/json: schema: type: object properties: id: type: string deleted: type: boolean required: - id - deleted '400': description: Bad Request content: application/json: schema: type: object properties: error: type: string message: type: string required: - error '401': description: Unauthorized content: application/json: schema: type: object properties: error: type: string message: type: string required: - error '404': description: Secret not found content: application/json: schema: type: object properties: error: type: string message: type: string required: - error '422': description: Unprocessable Entity content: application/json: schema: type: object properties: error: type: string message: type: string required: - error '500': description: Internal Server Error content: application/json: schema: type: object properties: error: type: string message: type: string required: - error operationId: deleteApiSecretsById parameters: - schema: type: string in: path name: id required: true description: Delete a secret tags: - Secrets components: securitySchemes: project_api_key: type: apiKey in: header name: X-Auth-Token description: 'Project API key for sending traces and accessing project-scoped resources. Format: sk-lw-... (no underscore). Obtain one by creating a project via the Admin API or the LangWatch UI.' admin_api_key: type: http scheme: bearer description: 'Admin API key for organization-level operations (managing projects, API keys). Create one in Settings > API Keys or via POST /api/api-keys. Format: sk-lw-{id}_{secret}.'