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

# List assessment and task statuses

> Returns built-in and tenant custom status definitions for assessment and task state rendering.



## OpenAPI

````yaml /api-reference/risk-assessment-agents.json get /status-definitions
openapi: 3.0.0
info:
  title: Minerva Agent Risk Assessments API
  version: 0.1.0-beta
  description: >-
    Beta customer API for creating, running, steering, reviewing, and concluding
    agent-driven risk assessments.
servers:
  - url: https://api.gominerva.com/risk-assessments/v2
    description: Central Minerva API route for beta agent risk assessment endpoints
security:
  - ApplicationApiKeyAuth: []
tags:
  - name: Configuration
    description: Workflow, status, and scorecard discovery.
  - name: Assessments
    description: Assessment lifecycle endpoints.
  - name: Review And Collaboration
    description: Comments, tasks, notes, questions, and confirmations.
  - name: Relationships Canvas
    description: Relationship canvas read and write endpoints.
  - name: Agent Runtime
    description: Run, trajectory, command, input, steering, and resume endpoints.
paths:
  /status-definitions:
    get:
      tags:
        - Configuration
      summary: List assessment and task statuses
      description: >-
        Returns built-in and tenant custom status definitions for assessment and
        task state rendering.
      operationId: listRiskAssessmentStatusDefinitions
      parameters:
        - $ref: '#/components/parameters/StatusKind'
        - $ref: '#/components/parameters/IncludeInactive'
      responses:
        '200':
          $ref: '#/components/responses/OkEnvelope'
        '401':
          $ref: '#/components/responses/ErrorEnvelope'
        '500':
          $ref: '#/components/responses/ErrorEnvelope'
components:
  parameters:
    StatusKind:
      name: kind
      in: query
      schema:
        type: string
        example: assessment,task
      description: Comma-separated status kinds.
    IncludeInactive:
      name: include_inactive
      in: query
      schema:
        type: boolean
        default: false
      description: Include inactive custom statuses.
  responses:
    OkEnvelope:
      description: OK
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Envelope'
    ErrorEnvelope:
      description: Error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorEnvelope'
  schemas:
    Envelope:
      type: object
      properties:
        status:
          type: integer
          example: 200
        msg:
          type: string
          example: OK
        result:
          $ref: '#/components/schemas/GenericObject'
      required:
        - status
        - msg
        - result
    ErrorEnvelope:
      type: object
      properties:
        status:
          type: integer
          example: 400
        msg:
          type: string
          example: Bad Request
        error:
          type: string
      required:
        - status
        - msg
    GenericObject:
      type: object
      additionalProperties: true
  securitySchemes:
    ApplicationApiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: Use the format `Api-Key YOUR_API_KEY`.

````