# 由 openapi/scripts/generate.php 生成，请勿手改；补充写到 overrides/v2-task-status-task-status.yaml
get:
  summary: '获取单个 task-status/{task_status}'
  tags:
    - task-status
  operationId: get_api_v2_task_status_task_status_
  description: 实现：`TaskStatusController@show`
  parameters:
    -
      name: task_status
      in: path
      required: true
      schema:
        type: string
  responses:
    200:
      description: '成功。业务失败时 HTTP 仍可能为 200，以 ok 字段为准。'
      content:
        application/json:
          schema:
            type: object
            properties:
              ok:
                type: boolean
              message:
                type: string
              data:
                type: object
    401:
      $ref: '../../main.yaml#/components/responses/Unauthorized'
    422:
      $ref: '../../main.yaml#/components/responses/ValidationError'
put:
  summary: '更新 task-status/{task_status}'
  tags:
    - task-status
  operationId: put_api_v2_task_status_task_status_
  description: 实现：`TaskStatusController@update`
  parameters:
    -
      name: task_status
      in: path
      required: true
      schema:
        type: string
  requestBody:
    required: false
    content:
      application/json:
        schema:
          type: object
          properties:
            status:
              type: string
              enum:
                - published
                - running
                - restarted
                - quit
                - done
                - requested_restart
  responses:
    200:
      description: '成功。业务失败时 HTTP 仍可能为 200，以 ok 字段为准。'
      content:
        application/json:
          schema:
            type: object
            properties:
              ok:
                type: boolean
              message:
                type: string
              data:
                type: object
                properties:
                  mode:
                    type: string
                  format:
                    type: string
                  footnote:
                    type: string
                  origin:
                    type: string
                  paragraph:
                    type: string
                  id:
                    type: integer
                  title:
                    type: string
                  description:
                    type: string
                  type:
                    type: integer
                  category:
                    type: string
                  progress:
                    type: integer
                  parent_id:
                    type: integer
                  parent:
                    type: string
                  roles:
                    type: string
                  executor_id:
                    type: integer
                  executor_relation_task_id:
                    type: integer
                  executor_relation_task:
                    type: string
                  pre_task:
                    type: string
                  next_task:
                    type: string
                  is_milestone:
                    type: boolean
                  project_id:
                    type: integer
                  project:
                    type: string
                  owner_id:
                    type: integer
                  owner:
                    type: string
                  editor_id:
                    type: integer
                  editor:
                    type: string
                  order:
                    type: string
                  status:
                    type: integer
                  created_at:
                    type: string
                  updated_at:
                    type: string
                  started_at:
                    type: string
                  finished_at:
                    type: string
                  assignees_id:
                    type: integer
                  assignees:
                    type: string
                  html:
                    type: string
                  executor:
                    type: string
    401:
      $ref: '../../main.yaml#/components/responses/Unauthorized'
    422:
      $ref: '../../main.yaml#/components/responses/ValidationError'
patch:
  summary: '更新 task-status/{task_status}'
  tags:
    - task-status
  operationId: patch_api_v2_task_status_task_status_
  description: 实现：`TaskStatusController@update`
  parameters:
    -
      name: task_status
      in: path
      required: true
      schema:
        type: string
  requestBody:
    required: false
    content:
      application/json:
        schema:
          type: object
          properties:
            status:
              type: string
              enum:
                - published
                - running
                - restarted
                - quit
                - done
                - requested_restart
  responses:
    200:
      description: '成功。业务失败时 HTTP 仍可能为 200，以 ok 字段为准。'
      content:
        application/json:
          schema:
            type: object
            properties:
              ok:
                type: boolean
              message:
                type: string
              data:
                type: object
                properties:
                  mode:
                    type: string
                  format:
                    type: string
                  footnote:
                    type: string
                  origin:
                    type: string
                  paragraph:
                    type: string
                  id:
                    type: integer
                  title:
                    type: string
                  description:
                    type: string
                  type:
                    type: integer
                  category:
                    type: string
                  progress:
                    type: integer
                  parent_id:
                    type: integer
                  parent:
                    type: string
                  roles:
                    type: string
                  executor_id:
                    type: integer
                  executor_relation_task_id:
                    type: integer
                  executor_relation_task:
                    type: string
                  pre_task:
                    type: string
                  next_task:
                    type: string
                  is_milestone:
                    type: boolean
                  project_id:
                    type: integer
                  project:
                    type: string
                  owner_id:
                    type: integer
                  owner:
                    type: string
                  editor_id:
                    type: integer
                  editor:
                    type: string
                  order:
                    type: string
                  status:
                    type: integer
                  created_at:
                    type: string
                  updated_at:
                    type: string
                  started_at:
                    type: string
                  finished_at:
                    type: string
                  assignees_id:
                    type: integer
                  assignees:
                    type: string
                  html:
                    type: string
                  executor:
                    type: string
    401:
      $ref: '../../main.yaml#/components/responses/Unauthorized'
    422:
      $ref: '../../main.yaml#/components/responses/ValidationError'
delete:
  summary: '删除 task-status/{task_status}'
  tags:
    - task-status
  operationId: delete_api_v2_task_status_task_status_
  description: 实现：`TaskStatusController@destroy`
  parameters:
    -
      name: task_status
      in: path
      required: true
      schema:
        type: string
  responses:
    200:
      description: '成功。业务失败时 HTTP 仍可能为 200，以 ok 字段为准。'
      content:
        application/json:
          schema:
            type: object
            properties:
              ok:
                type: boolean
              message:
                type: string
              data:
                type: object
    401:
      $ref: '../../main.yaml#/components/responses/Unauthorized'
    422:
      $ref: '../../main.yaml#/components/responses/ValidationError'