> ## Documentation Index
> Fetch the complete documentation index at: https://docs.prophecy.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Update secret

> Update the properties of a specific secret

<Tip>Open the secret in the Prophecy UI to see which properties can be updated.</Tip>


## OpenAPI

````yaml put /api/orchestration/fabric/{fabricId}/secret/id/{secretId}
openapi: 3.0.3
info:
  title: Prophecy Secrets API
  description: API for managing Prophecy secrets
  version: 1.0.0
servers: []
security: []
paths:
  /api/orchestration/fabric/{fabricId}/secret/id/{secretId}:
    parameters:
      - name: fabricId
        in: path
        description: The unique ID of the parent fabric
        required: true
        schema:
          type: string
      - name: secretId
        in: path
        description: The unique ID of the secret
        required: true
        schema:
          type: string
    put:
      tags:
        - Secrets
      summary: Update secret
      description: Update the properties of a specific secret
      operationId: updateSecret
      parameters:
        - $ref: '#/components/parameters/X-AUTH-TOKEN'
      requestBody:
        description: Secret object with updated fields
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - kind
                - subKind
                - properties
              properties:
                kind:
                  type: string
                  description: Secret management provider
                  enum:
                    - prophecy
                subKind:
                  type: string
                  description: Secret sub-type
                  enum:
                    - text
                    - binary
                    - username_password
                    - m2m_oauth
                properties:
                  type: object
                  description: >-
                    Secret properties that vary by `subKind`.


                    Find specific properties in the **Secrets > Properties**
                    section of the API documentation.
            example:
              kind: prophecy
              subKind: text
              properties:
                name: service_account_1
                value: <new-value>
      responses:
        '200':
          description: Secret updated successfully
          content:
            application/json:
              schema:
                type: object
                required:
                  - success
                properties:
                  success:
                    type: boolean
                    description: Indicates the request was successful.
                    enum:
                      - true
                  data:
                    type: object
                    properties:
                      id:
                        type: string
                        description: The unique identifier for the updated secret.
                    description: Response data containing the secret ID.
              example:
                success: true
                data:
                  id: '4656'
        '400':
          description: Bad request - Secret update failed
          content:
            application/json:
              schema:
                type: object
                required:
                  - success
                  - message
                properties:
                  success:
                    type: boolean
                    description: Indicates the request failed.
                    enum:
                      - false
                  message:
                    type: string
                    description: Error message describing why the request failed.
              example:
                success: false
                message: >-
                  Update Secret failed due to : Secret Store not found for
                  Secret ID: propcy
components:
  parameters:
    X-AUTH-TOKEN:
      name: X-AUTH-TOKEN
      in: header
      description: Prophecy authentication token. Required for all API requests.
      required: true
      schema:
        type: string

````