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

# Update an issue

> Updates an existing issue. Can be used to reassign, change status, update priority, or modify any other issue fields.



## OpenAPI

````yaml https://app.stainless.com/api/spec/documented/avido/openapi.documented.yml put /v0/issues/{id}
openapi: 3.1.1
info:
  title: Avido API
  description: >-
    Avido's API for LLM usage events, tool calls, trace management, webhook
    validation, and more. See each endpoint's request/response schema for
    details.
  version: 0.1.0
  contact:
    name: Avido Support
    email: support@avidoai.com
    url: https://avidoai.com/support
servers:
  - url: https://api.avidoai.com
    description: Production API
security:
  - ApiKey: []
    ApplicationId: []
paths:
  /v0/issues/{id}:
    put:
      tags:
        - Issues
      summary: Update an issue
      description: >-
        Updates an existing issue. Can be used to reassign, change status,
        update priority, or modify any other issue fields.
      operationId: updateIssue
      parameters:
        - in: path
          name: id
          schema:
            type: string
            format: uuid
            pattern: >-
              ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
            description: The unique identifier of the issue
            example: 123e4567-e89b-12d3-a456-426614174000
          required: true
          description: The unique identifier of the issue
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateIssueRequest'
            examples:
              statusUpdate:
                summary: Update issue status
                value:
                  status: RESOLVED
              reassign:
                summary: Reassign issue
                value:
                  assignedTo: user_345678
                  priority: LOW
              fullUpdate:
                summary: Full issue update
                value:
                  title: 'Updated: Critical performance issue'
                  summary: >-
                    System response time consistently exceeds 5 seconds during
                    peak hours
                  status: OPEN
                  priority: HIGH
                  assignedTo: user_345678
      responses:
        '200':
          description: Successfully updated issue
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IssueResponse'
        '400':
          description: bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Issue not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                notFound:
                  summary: No such issue
                  value:
                    message: Issue not found
        '422':
          description: invalid input
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationErrorResponse'
        '500':
          description: internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    UpdateIssueRequest:
      type: object
      properties:
        title:
          description: Updated title of the issue
          example: Response quality degradation - Critical
          type: string
        summary:
          anyOf:
            - type: string
            - type: 'null'
          description: Updated summary of the issue
          example: The chatbot is consistently providing incomplete responses
          nullable: true
        comment:
          anyOf:
            - type: string
            - type: 'null'
          description: Reason for resolving or dismissing the issue
          example: Duplicate report
          nullable: true
        status:
          $ref: '#/components/schemas/IssueStatus'
          description: Updated status of the issue
          example: RESOLVED
        priority:
          $ref: '#/components/schemas/IssuePriority'
          description: Updated priority level
          example: LOW
        type:
          $ref: '#/components/schemas/IssueType'
          description: Updated type/category
          example: HUMAN_ANNOTATION
        assignedTo:
          anyOf:
            - type: string
            - type: 'null'
          description: Reassign the issue to a different user
          example: user_345678
          nullable: true
        topicId:
          description: Update associated topic ID
          example: 789e4567-e89b-12d3-a456-426614174000
          nullable: true
          type: string
          format: uuid
          pattern: >-
            ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
        taskId:
          description: Update associated task ID
          example: 789e4567-e89b-12d3-a456-426614174000
          nullable: true
          type: string
          format: uuid
          pattern: >-
            ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
        testId:
          anyOf:
            - type: string
              format: uuid
              pattern: >-
                ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
            - type: 'null'
          description: Update associated test ID
          example: 789e4567-e89b-12d3-a456-426614174000
          nullable: true
        evalDefinitionId:
          description: Update associated evaluation definition ID
          example: 789e4567-e89b-12d3-a456-426614174000
          nullable: true
          type: string
          format: uuid
          pattern: >-
            ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
        annotationId:
          anyOf:
            - type: string
              format: uuid
              pattern: >-
                ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
            - type: 'null'
          description: Update associated annotation ID
          example: 890e5678-e89b-12d3-a456-426614174000
          nullable: true
        traceId:
          anyOf:
            - type: string
            - type: 'null'
          description: Update associated trace ID
          example: trace_xyz789
          nullable: true
        experimentId:
          anyOf:
            - type: string
              format: uuid
              pattern: >-
                ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
            - type: 'null'
          description: Update associated experiment ID
          example: 789e4567-e89b-12d3-a456-426614174000
          nullable: true
        parentId:
          anyOf:
            - type: string
              format: uuid
              pattern: >-
                ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
            - type: 'null'
          description: Update parent issue ID for sub-issues
          example: 123e4567-e89b-12d3-a456-426614174000
          nullable: true
      additionalProperties: false
      title: UpdateIssueRequest
      description: Request body for updating an existing issue
    IssueResponse:
      type: object
      properties:
        data:
          $ref: '#/components/schemas/IssueOutput'
      required:
        - data
      additionalProperties: false
      title: IssueResponse
      description: Successful response containing the issue data
    ErrorResponse:
      type: object
      properties:
        message:
          type: string
          description: A human-readable error message explaining the error.
          example: Resource not found
      required:
        - message
      additionalProperties: false
      title: ErrorResponse
      description: Standard error format for failed API operations.
    ValidationErrorResponse:
      type: object
      properties:
        message:
          type: string
          description: A human-readable error message indicating what went wrong.
          example: Invalid request data
        issues:
          type: array
          items:
            type: object
            properties:
              code:
                type: string
              message:
                type: string
              path:
                type: array
                items:
                  type: string
            required:
              - code
              - message
              - path
            additionalProperties: false
          description: Array of detailed validation error objects.
          example:
            - code: invalid_string
              message: Invalid UUID
              path:
                - id
      required:
        - message
        - issues
      additionalProperties: false
      title: ValidationErrorResponse
      description: Details about validation errors in incoming requests.
    IssueStatus:
      type: string
      enum:
        - OPEN
        - RESOLVED
        - REJECTED
      description: The status of the issue
      example: OPEN
    IssuePriority:
      type: string
      enum:
        - LOW
        - MEDIUM
        - HIGH
      description: The priority level of the issue
      example: MEDIUM
    IssueType:
      type: string
      enum:
        - BUG
        - HUMAN_ANNOTATION
        - SUGGESTED_TASK
        - USER_SIGNAL
      description: The type/category of the issue
      example: BUG
    IssueOutput:
      type: object
      properties:
        id:
          type: string
          format: uuid
          pattern: >-
            ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
          description: Unique identifier of the issue
          example: 123e4567-e89b-12d3-a456-426614174000
        title:
          type: string
          description: Title of the issue
          example: Response quality degradation
        createdAt:
          description: When the issue was created
          example: '2024-01-05T12:34:56.789Z'
          type: string
          format: date-time
          pattern: >-
            ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
        orgId:
          type: string
          description: Organization ID that owns this issue
          example: org_123456
        description:
          description: Detailed description of the issue
          example: The chatbot is providing incomplete responses to user queries
          type: string
        summary:
          description: Detailed summary of the issue
          example: The chatbot is providing incomplete responses to user queries
          type: string
        impact:
          description: Detailed impact of the issue
          example: The chatbot is providing incomplete responses to user queries
          type: string
        comment:
          description: Optional comment explaining resolution or dismissal
          example: Working as intended
          type: string
        status:
          $ref: '#/components/schemas/IssueStatus'
          description: Current status of the issue
        source:
          $ref: '#/components/schemas/IssueSource'
          description: Where the issue originated from
        priority:
          $ref: '#/components/schemas/IssuePriority'
          description: Priority level of the issue
          example: HIGH
        type:
          $ref: '#/components/schemas/IssueType'
          description: Type/category of the issue
        assignedTo:
          description: User ID of the person assigned to this issue
          example: user_789012
          type: string
        assignedUser:
          $ref: '#/components/schemas/AssignedUserInfoOutput'
          description: Full information about the assigned user
        applicationId:
          type: string
          format: uuid
          pattern: >-
            ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
          description: The application this issue belongs to
          example: 456e7890-e89b-12d3-a456-426614174000
        topicId:
          description: Associated topic ID if issue came from a topic
          example: 789e4567-e89b-12d3-a456-426614174000
          type: string
          format: uuid
          pattern: >-
            ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
        taskId:
          description: Associated task ID if issue came from a task
          example: 789e4567-e89b-12d3-a456-426614174000
          type: string
          format: uuid
          pattern: >-
            ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
        testId:
          description: Associated test ID if issue came from a test
          example: 789e4567-e89b-12d3-a456-426614174000
          type: string
          format: uuid
          pattern: >-
            ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
        evalDefinitionId:
          description: Associated evaluation definition ID if issue came from an evaluation
          example: 789e4567-e89b-12d3-a456-426614174000
          type: string
          format: uuid
          pattern: >-
            ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
        annotationId:
          description: Associated annotation ID if related to an annotation
          example: 890e5678-e89b-12d3-a456-426614174000
          type: string
          format: uuid
          pattern: >-
            ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
        traceId:
          description: Associated trace ID for monitoring/debugging
          example: trace_abc123
          type: string
        experimentId:
          description: Associated experiment ID if issue is linked to an experiment
          example: 789e4567-e89b-12d3-a456-426614174000
          type: string
          format: uuid
          pattern: >-
            ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
        parentId:
          description: Parent issue ID for sub-issues
          example: 123e4567-e89b-12d3-a456-426614174000
          type: string
          format: uuid
          pattern: >-
            ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
        modifiedAt:
          description: When the issue was last modified
          example: '2024-01-05T12:34:56.789Z'
          type: string
          format: date-time
          pattern: >-
            ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
        hasSuggestedTask:
          description: >-
            Whether this issue has an associated suggested task in draft status.
            True if the issue has a taskId and the task's status is DRAFT and
            the issue type is SUGGESTED_TASK.
          example: true
          type: boolean
      required:
        - id
        - title
        - createdAt
        - orgId
        - status
        - source
        - priority
        - type
        - applicationId
        - modifiedAt
      additionalProperties: false
      title: Issue
      description: An issue tracking problems or improvements in the AI application
    IssueSource:
      type: string
      enum:
        - TEST
        - TASK
        - TOPIC
        - SYSTEM
        - MONITORING
        - API
        - HUMAN_ANNOTATION
      description: The source where the issue was created from
      example: TEST
    AssignedUserInfoOutput:
      type: object
      properties:
        id:
          type: string
          description: User ID
          example: user_789012
        name:
          type: string
          description: User full name
          example: John Doe
        email:
          type: string
          format: email
          pattern: >-
            ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$
          description: User email
          example: john@example.com
        image:
          description: User profile image URL
          example: https://example.com/avatar.jpg
          type: string
      required:
        - id
        - name
        - email
      additionalProperties: false
      title: AssignedUserInfo
      description: Information about the user assigned to an issue
  securitySchemes:
    ApiKey:
      type: apiKey
      in: header
      name: x-api-key
      description: Your unique Avido API key
    ApplicationId:
      type: apiKey
      in: header
      name: x-application-id
      description: Your unique Avido Application ID

````