> ## Documentation Index > Fetch the complete documentation index at: https://docs.ankra.ai/llms.txt > Use this file to discover all available pages before exploring further. # Set Application Env Secret > Store the value of one environment secret, creating the entry or rotating it in place. The value goes to the platform secret store; the deploy renders it into the -env Secret, encrypted with SOPS to the organisation's age recipient before it is stored or pushed to Git. The value is not echoed in the response and is never logged. Takes effect on the application's next deploy. A browser session twin is mounted at the same path without the /api/v1 prefix (cookie authentication plus the X-Ankra-CSRF double-submit header). ## OpenAPI ````yaml https://platform.ankra.app/openapi.json put /api/v1/org/applications/{application_id}/env-secrets/{secret_key} openapi: 3.1.0 info: title: FastAPI version: 0.1.0 servers: - url: https://platform.ankra.app security: [] tags: - name: Clusters description: Create, inspect and manage clusters, and the stacks deployed on them. - name: Managed Clusters description: Provider-managed control planes, driven through one common surface. - name: Imported Clusters description: Clusters that already existed and were connected to Ankra. - name: Cluster Access description: Kubeconfigs, service-account tokens and per-cluster access grants. - name: Kubernetes description: Read and act on the Kubernetes objects inside a cluster. - name: DigitalOcean Clusters description: Provision and manage DigitalOcean Kubernetes clusters. - name: Hetzner Clusters description: Provision and manage Hetzner Kubernetes clusters. - name: OVH Clusters description: Provision and manage OVH Kubernetes clusters. - name: Scaleway Clusters description: Provision and manage Scaleway Kapsule clusters. - name: UpCloud Clusters description: Provision and manage UpCloud Kubernetes clusters. - name: Applications description: Deploy, configure and observe applications across the fleet. - name: Stack Profiles description: Reusable stack definitions, their versions and sharing. - name: Charts description: Browse the chart catalogue behind stacks and addons. - name: Helm description: Helm registries, credentials and the charts they expose. - name: Executions description: Long-running platform executions and their jobs. - name: Operations description: Cancel in-flight cluster operations and their jobs. - name: Chat description: Conversational sessions, plans and confirmable actions. - name: AI Agent Runs description: Autonomous agent runs and their outcomes. - name: AI Tickets description: The AI ticket board, its sync connections and settings. - name: AI Playbooks description: Reusable playbooks the AI lanes execute. - name: AI Conditions description: Conditions that gate AI autonomy. - name: AI Engineering Handoffs description: Work the AI lanes escalate to a human engineer. - name: AI Environment description: The environment and base stacks AI demos deploy into. - name: Security description: Findings, advisories, SBOMs, compliance and posture. - name: Cost description: Cluster and fleet cost, rate cards and cost settings. - name: Billing description: Subscription and spend caps. - name: Organisation description: Members, invitations, audit logs and organisation settings. - name: Account Tokens description: Personal access tokens for the API and CLI. - name: Credentials description: The shared credential store. - name: Azure Credentials description: Azure credentials and SSH keys. - name: DigitalOcean Credentials description: DigitalOcean credentials and SSH keys. - name: Hetzner Credentials description: Hetzner credentials and SSH keys. - name: OVH Credentials description: OVH credentials and SSH keys. - name: Scaleway Credentials description: Scaleway credentials. - name: UpCloud Credentials description: UpCloud credentials and SSH keys. - name: Data Source Credentials description: Credentials for metrics and log sources. - name: DNS Credentials description: Credentials for DNS providers. - name: DNS description: DNS zones and records, including custom organisation zones. - name: Cloudflare description: Cloudflare domains and the credentials behind them. - name: Variables description: Organisation- and cluster-scoped variables. - name: SOPS description: Encrypt and decrypt values with the organisation SOPS config. - name: Alerts description: Alert integrations and ingest credentials. - name: Notifications description: Notification routes and their delivery targets. - name: Support description: Support tickets. paths: /api/v1/org/applications/{application_id}/env-secrets/{secret_key}: put: tags: - Applications summary: Set Application Env Secret description: >- Store the value of one environment secret, creating the entry or rotating it in place. The value goes to the platform secret store; the deploy renders it into the -env Secret, encrypted with SOPS to the organisation's age recipient before it is stored or pushed to Git. The value is not echoed in the response and is never logged. Takes effect on the application's next deploy. A browser session twin is mounted at the same path without the /api/v1 prefix (cookie authentication plus the X-Ankra-CSRF double-submit header). operationId: >- set_application_env_secret_api_v1_org_applications__application_id__env_secrets__secret_key__put parameters: - in: path name: application_id required: true schema: type: string title: Application Id - in: path name: secret_key required: true schema: title: Secret Key type: string - in: header name: authorization required: false schema: anyOf: - type: string - type: 'null' title: Authorization - in: header name: x-ankra-organisation-id required: false schema: anyOf: - type: string - type: 'null' title: X-Ankra-Organisation-Id requestBody: content: application/json: schema: $ref: '#/components/schemas/SetApplicationEnvSecretRequest' required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/ApplicationEnvSecretItem' description: The catalogued key after the write. It carries no value. '400': content: application/json: schema: $ref: '#/components/schemas/DemoDetailError' description: >- The key is not a valid environment variable name, or the value failed the platform's secret-value rules '401': description: Unauthorized '403': content: application/json: schema: $ref: '#/components/schemas/DemoDetailError' description: CSRF check failed (browser twin only) '404': content: application/json: schema: $ref: '#/components/schemas/DemoDetailError' description: Not found ("Application not found") '422': content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' description: Validation Error '503': content: application/json: schema: $ref: '#/components/schemas/DemoDetailError' description: The secret store is not available ("Secret store is not available") components: schemas: SetApplicationEnvSecretRequest: description: >- The value to store for one environment secret. It is write-only: it is never echoed by this response, returned by any read, or written to a log. properties: value: title: Value type: string required: - value title: SetApplicationEnvSecretRequest type: object ApplicationEnvSecretItem: description: >- One key of an application's -env Secret. The stored value is never part of this model - no endpoint on this surface returns one. properties: key: type: string title: Key required: description: >- True when the application's committed manifests read this key through a secretKeyRef. title: Required type: boolean status: description: >- "set" when the secret store holds a value for this key, "value_missing" when the value was removed out of band. enum: - set - value_missing title: Status type: string updated_at: title: Updated At type: string updated_by: anyOf: - type: string - type: 'null' title: Updated By required: - key - required - status - updated_at - updated_by title: ApplicationEnvSecretItem type: object DemoDetailError: description: >- The FastAPI-style detail envelope the demo routes use for 400/403/404/409/502 responses. properties: detail: type: string required: - detail type: object HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' title: Detail type: array title: HTTPValidationError type: object ValidationError: properties: loc: items: anyOf: - type: string - type: integer title: Location type: array msg: title: Message type: string type: title: Error Type type: string required: - loc - msg - type title: ValidationError type: object ````