> ## Documentation Index
> Fetch the complete documentation index at: https://conductorone-eu-instance.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Update

> Update modifies a report's display name, prompt, or parameter values.
 Only the report's creator can update it.



## OpenAPI

````yaml https://spec.speakeasy.com/conductor-one/conductorone/my-source-with-code-samples post /api/v1/reporting/reports/{id}
openapi: 3.1.0
info:
  description: The C1 API is a HTTP API for managing C1 resources.
  title: C1 API
  version: 0.1.0-alpha
servers:
  - description: The C1 API server for the current tenant.
    url: https://{tenantDomain}.conductor.one
    variables:
      tenantDomain:
        default: example
        description: The domain of the tenant to use for this request.
security:
  - bearerAuth: []
    oauth: []
paths:
  /api/v1/reporting/reports/{id}:
    post:
      tags:
        - Report
      summary: Update
      description: |-
        Update modifies a report's display name, prompt, or parameter values.
         Only the report's creator can update it.
      operationId: c1.api.reporting.v1.ReportingService.Update
      parameters:
        - in: path
          name: id
          required: true
          schema:
            description: The id field.
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: >-
                #/components/schemas/c1.api.reporting.v1.ReportingServiceUpdateRequestInput
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/c1.api.reporting.v1.ReportingServiceUpdateResponse
          description: Successful response
components:
  schemas:
    c1.api.reporting.v1.ReportingServiceUpdateRequestInput:
      description: >-
        Both editable fields are optional; an empty one leaves the stored value
        alone.
         At least one must be set.
      properties:
        displayName:
          description: The displayName field.
          type: string
        expectedProgramId:
          description: >-
            Required with parameter_values. Prevents values prepared for one
            source
             version from being installed after an assistant edit advances the report.
          type: string
        parameterValues:
          additionalProperties: true
          type:
            - object
            - 'null'
        prompt:
          description: |-
            Editing this does not re-plan, so it may drift from
             program.planned_from_prompt — that drift is how a stale report is detected.
          type: string
      title: Reporting Service Update Request
      type: object
      x-speakeasy-name-override: ReportingServiceUpdateRequest
    c1.api.reporting.v1.ReportingServiceUpdateResponse:
      description: The ReportingServiceUpdateResponse message.
      properties:
        report:
          oneOf:
            - $ref: '#/components/schemas/c1.api.reporting.v1.Report'
            - type: 'null'
      title: Reporting Service Update Response
      type: object
      x-speakeasy-name-override: ReportingServiceUpdateResponse
    c1.api.reporting.v1.Report:
      description: >-
        Report is a saved report: the question, the program that answers it, and
        the
         parameters a re-run may vary.
      properties:
        createdAt:
          format: date-time
          type:
            - string
            - 'null'
        createdByUserId:
          description: The createdByUserId field.
          type: string
        deletedAt:
          format: date-time
          type:
            - string
            - 'null'
        displayName:
          description: The displayName field.
          type: string
        id:
          description: The id field.
          type: string
        latestRunId:
          description: >-
            Separate pointers: the last attempt may have failed while callers
            still need
             the last renderable result.
          type: string
        latestSuccessfulRunId:
          description: The latestSuccessfulRunId field.
          type: string
        parameterSchema:
          additionalProperties: true
          type:
            - object
            - 'null'
        parameterValues:
          additionalProperties: true
          type:
            - object
            - 'null'
        program:
          oneOf:
            - $ref: '#/components/schemas/c1.api.reporting.v1.ProgramRef'
            - type: 'null'
        prompt:
          description: The editable natural-language question. Only a re-plan reads this.
          type: string
        tenantId:
          description: The tenantId field.
          type: string
        updatedAt:
          format: date-time
          type:
            - string
            - 'null'
      title: Report
      type: object
      x-speakeasy-name-override: Report
    c1.api.reporting.v1.ProgramRef:
      description: ProgramRef identifies a report's own copy of an executable program.
      properties:
        commitId:
          deprecated: true
          description: The commitId field.
          type: string
        functionId:
          deprecated: true
          description: >-
            Deprecated tombstones. Source-owned reports never populate Function
            or
             commit identity; these declarations remain only because c1api forbids
             deleting published fields.
          type: string
        plannedFromPrompt:
          description: >-
            The prompt this program was planned from. Report.prompt is editable
            and a
             refresh never re-plans, so this is the only way to detect that a report's
             question has drifted from the program answering it.
          type: string
        programId:
          description: Identifies this durable source version. Minted for each save.
          type: string
      title: Program Ref
      type: object
      x-speakeasy-name-override: ProgramRef
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http
    oauth:
      description: >-
        This API uses OAuth2 with the Client Credential flow.

        Client Credentials must be sent in the BODY, not the headers.

        For an example of how to implement this, refer to the
        [c1TokenSource.Token()](https://github.com/ConductorOne/conductorone-sdk-go/blob/3375fe7c0126d17e7ec4e711693dee7b791023aa/token_source.go#L101-L187)
        function.
      flows:
        clientCredentials:
          scopes: {}
          tokenUrl: /auth/v1/token
      type: oauth2

````