@tutti-os/workspace-issue-manager 0.0.1

package/openapi/issue-manager.v1.yaml

@@ -0,0 +1,1682 @@
+openapi: 3.0.3
+info:
+  title: Workspace Issue Manager API Fragment
+  version: 1.0.0
+tags:
+  - name: issue
+paths:
+  /v1/workspaces/{workspaceID}/issue-topics:
+    parameters:
+      - $ref: "#/components/parameters/WorkspaceID"
+    get:
+      operationId: listWorkspaceIssueTopics
+      tags:
+        - issue
+      summary: List issue-manager topics for one workspace
+      responses:
+        "200":
+          description: Workspace issue topics
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/IssueManagerTopicListResponse"
+        "400":
+          $ref: "#/components/responses/InvalidRequestError"
+        "401":
+          $ref: "#/components/responses/UnauthorizedError"
+        "404":
+          $ref: "#/components/responses/WorkspaceNotFoundError"
+        "405":
+          $ref: "#/components/responses/MethodNotAllowedError"
+        "502":
+          $ref: "#/components/responses/WorkspaceOperationError"
+        "503":
+          $ref: "#/components/responses/ServiceUnavailableError"
+    post:
+      operationId: createWorkspaceIssueTopic
+      tags:
+        - issue
+      summary: Create one issue-manager topic
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/CreateIssueManagerTopicRequest"
+      responses:
+        "201":
+          description: Workspace issue topic created
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/IssueManagerTopicResponse"
+        "400":
+          $ref: "#/components/responses/InvalidRequestError"
+        "401":
+          $ref: "#/components/responses/UnauthorizedError"
+        "404":
+          $ref: "#/components/responses/WorkspaceNotFoundError"
+        "405":
+          $ref: "#/components/responses/MethodNotAllowedError"
+        "409":
+          $ref: "#/components/responses/WorkspaceIssueResourceExistsError"
+        "502":
+          $ref: "#/components/responses/WorkspaceOperationError"
+        "503":
+          $ref: "#/components/responses/ServiceUnavailableError"
+  /v1/workspaces/{workspaceID}/issue-topics/{topicID}:
+    parameters:
+      - $ref: "#/components/parameters/WorkspaceID"
+      - $ref: "#/components/parameters/IssueManagerTopicID"
+    patch:
+      operationId: updateWorkspaceIssueTopic
+      tags:
+        - issue
+      summary: Update one issue-manager topic
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/UpdateIssueManagerTopicRequest"
+      responses:
+        "200":
+          description: Workspace issue topic updated
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/IssueManagerTopicResponse"
+        "400":
+          $ref: "#/components/responses/InvalidRequestError"
+        "401":
+          $ref: "#/components/responses/UnauthorizedError"
+        "404":
+          $ref: "#/components/responses/WorkspaceIssueResourceNotFoundError"
+        "405":
+          $ref: "#/components/responses/MethodNotAllowedError"
+        "502":
+          $ref: "#/components/responses/WorkspaceOperationError"
+        "503":
+          $ref: "#/components/responses/ServiceUnavailableError"
+    delete:
+      operationId: deleteWorkspaceIssueTopic
+      tags:
+        - issue
+      summary: Delete one issue-manager topic
+      responses:
+        "200":
+          description: Workspace issue topic deleted
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/DeleteIssueManagerTopicResponse"
+        "400":
+          $ref: "#/components/responses/InvalidRequestError"
+        "401":
+          $ref: "#/components/responses/UnauthorizedError"
+        "404":
+          $ref: "#/components/responses/WorkspaceIssueResourceNotFoundError"
+        "405":
+          $ref: "#/components/responses/MethodNotAllowedError"
+        "409":
+          $ref: "#/components/responses/WorkspaceIssueResourceExistsError"
+        "502":
+          $ref: "#/components/responses/WorkspaceOperationError"
+        "503":
+          $ref: "#/components/responses/ServiceUnavailableError"
+  /v1/workspaces/{workspaceID}/issues:
+    parameters:
+      - $ref: "#/components/parameters/WorkspaceID"
+    get:
+      operationId: listWorkspaceIssues
+      tags:
+        - issue
+      summary: List issue-manager issues for one workspace
+      parameters:
+        - $ref: "#/components/parameters/IssueManagerPageSize"
+        - $ref: "#/components/parameters/IssueManagerPageToken"
+        - $ref: "#/components/parameters/IssueManagerTopicIDQuery"
+        - $ref: "#/components/parameters/IssueManagerStatusFilter"
+        - $ref: "#/components/parameters/IssueManagerSearchQuery"
+      responses:
+        "200":
+          description: Workspace issues
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/IssueManagerIssueListResponse"
+        "400":
+          $ref: "#/components/responses/InvalidRequestError"
+        "401":
+          $ref: "#/components/responses/UnauthorizedError"
+        "404":
+          $ref: "#/components/responses/WorkspaceNotFoundError"
+        "405":
+          $ref: "#/components/responses/MethodNotAllowedError"
+        "502":
+          $ref: "#/components/responses/WorkspaceOperationError"
+        "503":
+          $ref: "#/components/responses/ServiceUnavailableError"
+    post:
+      operationId: createWorkspaceIssue
+      tags:
+        - issue
+      summary: Create one issue-manager issue
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/CreateIssueManagerIssueRequest"
+      responses:
+        "201":
+          description: Workspace issue created
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/IssueManagerIssueResponse"
+        "400":
+          $ref: "#/components/responses/InvalidRequestError"
+        "401":
+          $ref: "#/components/responses/UnauthorizedError"
+        "404":
+          $ref: "#/components/responses/WorkspaceNotFoundError"
+        "405":
+          $ref: "#/components/responses/MethodNotAllowedError"
+        "409":
+          $ref: "#/components/responses/WorkspaceIssueResourceExistsError"
+        "502":
+          $ref: "#/components/responses/WorkspaceOperationError"
+        "503":
+          $ref: "#/components/responses/ServiceUnavailableError"
+  /v1/workspaces/{workspaceID}/issues/{issueID}:
+    parameters:
+      - $ref: "#/components/parameters/WorkspaceID"
+      - $ref: "#/components/parameters/IssueManagerIssueID"
+    get:
+      operationId: getWorkspaceIssueDetail
+      tags:
+        - issue
+      summary: Get one issue-manager issue detail
+      responses:
+        "200":
+          description: Workspace issue detail
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/IssueManagerIssueDetailResponse"
+        "400":
+          $ref: "#/components/responses/InvalidRequestError"
+        "401":
+          $ref: "#/components/responses/UnauthorizedError"
+        "404":
+          $ref: "#/components/responses/WorkspaceIssueResourceNotFoundError"
+        "405":
+          $ref: "#/components/responses/MethodNotAllowedError"
+        "502":
+          $ref: "#/components/responses/WorkspaceOperationError"
+        "503":
+          $ref: "#/components/responses/ServiceUnavailableError"
+    patch:
+      operationId: updateWorkspaceIssue
+      tags:
+        - issue
+      summary: Update one issue-manager issue
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/UpdateIssueManagerIssueRequest"
+      responses:
+        "200":
+          description: Workspace issue updated
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/IssueManagerIssueResponse"
+        "400":
+          $ref: "#/components/responses/InvalidRequestError"
+        "401":
+          $ref: "#/components/responses/UnauthorizedError"
+        "404":
+          $ref: "#/components/responses/WorkspaceIssueResourceNotFoundError"
+        "405":
+          $ref: "#/components/responses/MethodNotAllowedError"
+        "502":
+          $ref: "#/components/responses/WorkspaceOperationError"
+        "503":
+          $ref: "#/components/responses/ServiceUnavailableError"
+    delete:
+      operationId: deleteWorkspaceIssue
+      tags:
+        - issue
+      summary: Delete one issue-manager issue
+      responses:
+        "200":
+          description: Workspace issue deleted
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/DeleteIssueManagerIssueResponse"
+        "400":
+          $ref: "#/components/responses/InvalidRequestError"
+        "401":
+          $ref: "#/components/responses/UnauthorizedError"
+        "404":
+          $ref: "#/components/responses/WorkspaceIssueResourceNotFoundError"
+        "405":
+          $ref: "#/components/responses/MethodNotAllowedError"
+        "502":
+          $ref: "#/components/responses/WorkspaceOperationError"
+        "503":
+          $ref: "#/components/responses/ServiceUnavailableError"
+  /v1/workspaces/{workspaceID}/issues/{issueID}/context-refs:
+    parameters:
+      - $ref: "#/components/parameters/WorkspaceID"
+      - $ref: "#/components/parameters/IssueManagerIssueID"
+    post:
+      operationId: addWorkspaceIssueContextRefs
+      tags:
+        - issue
+      summary: Add context references to one issue-manager issue
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/AddIssueManagerContextRefsRequest"
+      responses:
+        "200":
+          description: Workspace issue context references added
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/IssueManagerContextRefsResponse"
+        "400":
+          $ref: "#/components/responses/InvalidRequestError"
+        "401":
+          $ref: "#/components/responses/UnauthorizedError"
+        "404":
+          $ref: "#/components/responses/WorkspaceIssueResourceNotFoundError"
+        "405":
+          $ref: "#/components/responses/MethodNotAllowedError"
+        "409":
+          $ref: "#/components/responses/WorkspaceIssueResourceExistsError"
+        "502":
+          $ref: "#/components/responses/WorkspaceOperationError"
+        "503":
+          $ref: "#/components/responses/ServiceUnavailableError"
+  /v1/workspaces/{workspaceID}/issues/{issueID}/context-refs/{contextRefID}:
+    parameters:
+      - $ref: "#/components/parameters/WorkspaceID"
+      - $ref: "#/components/parameters/IssueManagerIssueID"
+      - $ref: "#/components/parameters/IssueManagerContextRefID"
+    delete:
+      operationId: removeWorkspaceIssueContextRef
+      tags:
+        - issue
+      summary: Remove one issue-manager context reference
+      responses:
+        "200":
+          description: Workspace issue-manager context reference removed
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/DeleteIssueManagerContextRefResponse"
+        "400":
+          $ref: "#/components/responses/InvalidRequestError"
+        "401":
+          $ref: "#/components/responses/UnauthorizedError"
+        "404":
+          $ref: "#/components/responses/WorkspaceIssueResourceNotFoundError"
+        "405":
+          $ref: "#/components/responses/MethodNotAllowedError"
+        "502":
+          $ref: "#/components/responses/WorkspaceOperationError"
+        "503":
+          $ref: "#/components/responses/ServiceUnavailableError"
+  /v1/workspaces/{workspaceID}/issues/{issueID}/runs:
+    parameters:
+      - $ref: "#/components/parameters/WorkspaceID"
+      - $ref: "#/components/parameters/IssueManagerIssueID"
+    get:
+      operationId: listWorkspaceIssueRuns
+      tags:
+        - issue
+      summary: List runs for one issue-manager issue
+      responses:
+        "200":
+          description: Workspace issue runs
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/IssueManagerRunListResponse"
+        "400":
+          $ref: "#/components/responses/InvalidRequestError"
+        "401":
+          $ref: "#/components/responses/UnauthorizedError"
+        "404":
+          $ref: "#/components/responses/WorkspaceIssueResourceNotFoundError"
+        "405":
+          $ref: "#/components/responses/MethodNotAllowedError"
+        "502":
+          $ref: "#/components/responses/WorkspaceOperationError"
+        "503":
+          $ref: "#/components/responses/ServiceUnavailableError"
+    post:
+      operationId: createWorkspaceIssueRun
+      tags:
+        - issue
+      summary: Create one run for an issue-manager issue
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/CreateIssueManagerRunRequest"
+      responses:
+        "201":
+          description: Workspace issue run created
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/IssueManagerRunResponse"
+        "400":
+          $ref: "#/components/responses/InvalidRequestError"
+        "401":
+          $ref: "#/components/responses/UnauthorizedError"
+        "404":
+          $ref: "#/components/responses/WorkspaceIssueResourceNotFoundError"
+        "405":
+          $ref: "#/components/responses/MethodNotAllowedError"
+        "409":
+          $ref: "#/components/responses/WorkspaceIssueResourceExistsError"
+        "502":
+          $ref: "#/components/responses/WorkspaceOperationError"
+        "503":
+          $ref: "#/components/responses/ServiceUnavailableError"
+  /v1/workspaces/{workspaceID}/issues/{issueID}/runs/{runID}:
+    parameters:
+      - $ref: "#/components/parameters/WorkspaceID"
+      - $ref: "#/components/parameters/IssueManagerIssueID"
+      - $ref: "#/components/parameters/IssueManagerRunID"
+    get:
+      operationId: getWorkspaceIssueRun
+      tags:
+        - issue
+      summary: Get one issue-manager issue run
+      responses:
+        "200":
+          description: Workspace issue run
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/IssueManagerRunEnvelope"
+        "400":
+          $ref: "#/components/responses/InvalidRequestError"
+        "401":
+          $ref: "#/components/responses/UnauthorizedError"
+        "404":
+          $ref: "#/components/responses/WorkspaceIssueResourceNotFoundError"
+        "405":
+          $ref: "#/components/responses/MethodNotAllowedError"
+        "502":
+          $ref: "#/components/responses/WorkspaceOperationError"
+        "503":
+          $ref: "#/components/responses/ServiceUnavailableError"
+    patch:
+      operationId: completeWorkspaceIssueRun
+      tags:
+        - issue
+      summary: Complete one issue-manager issue run
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/CompleteIssueManagerRunRequest"
+      responses:
+        "200":
+          description: Workspace issue run completed
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/IssueManagerRunEnvelope"
+        "400":
+          $ref: "#/components/responses/InvalidRequestError"
+        "401":
+          $ref: "#/components/responses/UnauthorizedError"
+        "404":
+          $ref: "#/components/responses/WorkspaceIssueResourceNotFoundError"
+        "405":
+          $ref: "#/components/responses/MethodNotAllowedError"
+        "502":
+          $ref: "#/components/responses/WorkspaceOperationError"
+        "503":
+          $ref: "#/components/responses/ServiceUnavailableError"
+  /v1/workspaces/{workspaceID}/issues/{issueID}/tasks:
+    parameters:
+      - $ref: "#/components/parameters/WorkspaceID"
+      - $ref: "#/components/parameters/IssueManagerIssueID"
+    get:
+      operationId: listWorkspaceIssueTasks
+      tags:
+        - issue
+      summary: List tasks for one issue-manager issue
+      parameters:
+        - $ref: "#/components/parameters/IssueManagerPageSize"
+        - $ref: "#/components/parameters/IssueManagerPageToken"
+        - $ref: "#/components/parameters/IssueManagerStatusFilter"
+        - $ref: "#/components/parameters/IssueManagerSearchQuery"
+      responses:
+        "200":
+          description: Workspace issue tasks
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/IssueManagerTaskListResponse"
+        "400":
+          $ref: "#/components/responses/InvalidRequestError"
+        "401":
+          $ref: "#/components/responses/UnauthorizedError"
+        "404":
+          $ref: "#/components/responses/WorkspaceIssueResourceNotFoundError"
+        "405":
+          $ref: "#/components/responses/MethodNotAllowedError"
+        "502":
+          $ref: "#/components/responses/WorkspaceOperationError"
+        "503":
+          $ref: "#/components/responses/ServiceUnavailableError"
+    post:
+      operationId: createWorkspaceIssueTask
+      tags:
+        - issue
+      summary: Create one task for an issue-manager issue
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/CreateIssueManagerTaskRequest"
+      responses:
+        "201":
+          description: Workspace issue task created
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/IssueManagerTaskResponse"
+        "400":
+          $ref: "#/components/responses/InvalidRequestError"
+        "401":
+          $ref: "#/components/responses/UnauthorizedError"
+        "404":
+          $ref: "#/components/responses/WorkspaceIssueResourceNotFoundError"
+        "405":
+          $ref: "#/components/responses/MethodNotAllowedError"
+        "409":
+          $ref: "#/components/responses/WorkspaceIssueResourceExistsError"
+        "502":
+          $ref: "#/components/responses/WorkspaceOperationError"
+        "503":
+          $ref: "#/components/responses/ServiceUnavailableError"
+  /v1/workspaces/{workspaceID}/issues/{issueID}/tasks/{taskID}:
+    parameters:
+      - $ref: "#/components/parameters/WorkspaceID"
+      - $ref: "#/components/parameters/IssueManagerIssueID"
+      - $ref: "#/components/parameters/IssueManagerTaskID"
+    get:
+      operationId: getWorkspaceIssueTaskDetail
+      tags:
+        - issue
+      summary: Get one issue-manager task detail
+      responses:
+        "200":
+          description: Workspace issue task detail
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/IssueManagerTaskDetailResponse"
+        "400":
+          $ref: "#/components/responses/InvalidRequestError"
+        "401":
+          $ref: "#/components/responses/UnauthorizedError"
+        "404":
+          $ref: "#/components/responses/WorkspaceIssueResourceNotFoundError"
+        "405":
+          $ref: "#/components/responses/MethodNotAllowedError"
+        "502":
+          $ref: "#/components/responses/WorkspaceOperationError"
+        "503":
+          $ref: "#/components/responses/ServiceUnavailableError"
+    patch:
+      operationId: updateWorkspaceIssueTask
+      tags:
+        - issue
+      summary: Update one issue-manager task
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/UpdateIssueManagerTaskRequest"
+      responses:
+        "200":
+          description: Workspace issue task updated
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/IssueManagerTaskResponse"
+        "400":
+          $ref: "#/components/responses/InvalidRequestError"
+        "401":
+          $ref: "#/components/responses/UnauthorizedError"
+        "404":
+          $ref: "#/components/responses/WorkspaceIssueResourceNotFoundError"
+        "405":
+          $ref: "#/components/responses/MethodNotAllowedError"
+        "502":
+          $ref: "#/components/responses/WorkspaceOperationError"
+        "503":
+          $ref: "#/components/responses/ServiceUnavailableError"
+    delete:
+      operationId: deleteWorkspaceIssueTask
+      tags:
+        - issue
+      summary: Delete one issue-manager task
+      responses:
+        "200":
+          description: Workspace issue task deleted
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/DeleteIssueManagerTaskResponse"
+        "400":
+          $ref: "#/components/responses/InvalidRequestError"
+        "401":
+          $ref: "#/components/responses/UnauthorizedError"
+        "404":
+          $ref: "#/components/responses/WorkspaceIssueResourceNotFoundError"
+        "405":
+          $ref: "#/components/responses/MethodNotAllowedError"
+        "502":
+          $ref: "#/components/responses/WorkspaceOperationError"
+        "503":
+          $ref: "#/components/responses/ServiceUnavailableError"
+  /v1/workspaces/{workspaceID}/issues/{issueID}/tasks/{taskID}/context-refs:
+    parameters:
+      - $ref: "#/components/parameters/WorkspaceID"
+      - $ref: "#/components/parameters/IssueManagerIssueID"
+      - $ref: "#/components/parameters/IssueManagerTaskID"
+    post:
+      operationId: addWorkspaceIssueTaskContextRefs
+      tags:
+        - issue
+      summary: Add context references to one issue-manager task
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/AddIssueManagerContextRefsRequest"
+      responses:
+        "200":
+          description: Workspace issue task context references added
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/IssueManagerContextRefsResponse"
+        "400":
+          $ref: "#/components/responses/InvalidRequestError"
+        "401":
+          $ref: "#/components/responses/UnauthorizedError"
+        "404":
+          $ref: "#/components/responses/WorkspaceIssueResourceNotFoundError"
+        "405":
+          $ref: "#/components/responses/MethodNotAllowedError"
+        "409":
+          $ref: "#/components/responses/WorkspaceIssueResourceExistsError"
+        "502":
+          $ref: "#/components/responses/WorkspaceOperationError"
+        "503":
+          $ref: "#/components/responses/ServiceUnavailableError"
+  /v1/workspaces/{workspaceID}/issues/{issueID}/tasks/{taskID}/context-refs/{contextRefID}:
+    parameters:
+      - $ref: "#/components/parameters/WorkspaceID"
+      - $ref: "#/components/parameters/IssueManagerIssueID"
+      - $ref: "#/components/parameters/IssueManagerTaskID"
+      - $ref: "#/components/parameters/IssueManagerContextRefID"
+    delete:
+      operationId: removeWorkspaceIssueTaskContextRef
+      tags:
+        - issue
+      summary: Remove one task-scoped issue-manager context reference
+      responses:
+        "200":
+          description: Workspace issue-manager task context reference removed
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/DeleteIssueManagerContextRefResponse"
+        "400":
+          $ref: "#/components/responses/InvalidRequestError"
+        "401":
+          $ref: "#/components/responses/UnauthorizedError"
+        "404":
+          $ref: "#/components/responses/WorkspaceIssueResourceNotFoundError"
+        "405":
+          $ref: "#/components/responses/MethodNotAllowedError"
+        "502":
+          $ref: "#/components/responses/WorkspaceOperationError"
+        "503":
+          $ref: "#/components/responses/ServiceUnavailableError"
+  /v1/workspaces/{workspaceID}/issues/{issueID}/tasks/{taskID}/runs:
+    parameters:
+      - $ref: "#/components/parameters/WorkspaceID"
+      - $ref: "#/components/parameters/IssueManagerIssueID"
+      - $ref: "#/components/parameters/IssueManagerTaskID"
+    get:
+      operationId: listWorkspaceIssueTaskRuns
+      tags:
+        - issue
+      summary: List runs for one issue-manager task
+      responses:
+        "200":
+          description: Workspace issue task runs
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/IssueManagerRunListResponse"
+        "400":
+          $ref: "#/components/responses/InvalidRequestError"
+        "401":
+          $ref: "#/components/responses/UnauthorizedError"
+        "404":
+          $ref: "#/components/responses/WorkspaceIssueResourceNotFoundError"
+        "405":
+          $ref: "#/components/responses/MethodNotAllowedError"
+        "502":
+          $ref: "#/components/responses/WorkspaceOperationError"
+        "503":
+          $ref: "#/components/responses/ServiceUnavailableError"
+    post:
+      operationId: createWorkspaceIssueTaskRun
+      tags:
+        - issue
+      summary: Create one run for an issue-manager task
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/CreateIssueManagerRunRequest"
+      responses:
+        "201":
+          description: Workspace issue task run created
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/IssueManagerRunResponse"
+        "400":
+          $ref: "#/components/responses/InvalidRequestError"
+        "401":
+          $ref: "#/components/responses/UnauthorizedError"
+        "404":
+          $ref: "#/components/responses/WorkspaceIssueResourceNotFoundError"
+        "405":
+          $ref: "#/components/responses/MethodNotAllowedError"
+        "409":
+          $ref: "#/components/responses/WorkspaceIssueResourceExistsError"
+        "502":
+          $ref: "#/components/responses/WorkspaceOperationError"
+        "503":
+          $ref: "#/components/responses/ServiceUnavailableError"
+  /v1/workspaces/{workspaceID}/issues/{issueID}/tasks/{taskID}/runs/{runID}:
+    parameters:
+      - $ref: "#/components/parameters/WorkspaceID"
+      - $ref: "#/components/parameters/IssueManagerIssueID"
+      - $ref: "#/components/parameters/IssueManagerTaskID"
+      - $ref: "#/components/parameters/IssueManagerRunID"
+    get:
+      operationId: getWorkspaceIssueTaskRun
+      tags:
+        - issue
+      summary: Get one issue-manager task run
+      responses:
+        "200":
+          description: Workspace issue task run
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/IssueManagerRunEnvelope"
+        "400":
+          $ref: "#/components/responses/InvalidRequestError"
+        "401":
+          $ref: "#/components/responses/UnauthorizedError"
+        "404":
+          $ref: "#/components/responses/WorkspaceIssueResourceNotFoundError"
+        "405":
+          $ref: "#/components/responses/MethodNotAllowedError"
+        "502":
+          $ref: "#/components/responses/WorkspaceOperationError"
+        "503":
+          $ref: "#/components/responses/ServiceUnavailableError"
+    patch:
+      operationId: completeWorkspaceIssueTaskRun
+      tags:
+        - issue
+      summary: Complete one issue-manager task run
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/CompleteIssueManagerRunRequest"
+      responses:
+        "200":
+          description: Workspace issue task run completed
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/IssueManagerRunEnvelope"
+        "400":
+          $ref: "#/components/responses/InvalidRequestError"
+        "401":
+          $ref: "#/components/responses/UnauthorizedError"
+        "404":
+          $ref: "#/components/responses/WorkspaceIssueResourceNotFoundError"
+        "405":
+          $ref: "#/components/responses/MethodNotAllowedError"
+        "502":
+          $ref: "#/components/responses/WorkspaceOperationError"
+        "503":
+          $ref: "#/components/responses/ServiceUnavailableError"
+components:
+  parameters:
+    IssueManagerIssueID:
+      name: issueID
+      in: path
+      required: true
+      schema:
+        type: string
+        minLength: 1
+    IssueManagerTopicID:
+      name: topicID
+      in: path
+      required: true
+      schema:
+        type: string
+        minLength: 1
+    IssueManagerTopicIDQuery:
+      name: topicId
+      in: query
+      required: true
+      schema:
+        type: string
+        minLength: 1
+    IssueManagerTaskID:
+      name: taskID
+      in: path
+      required: true
+      schema:
+        type: string
+        minLength: 1
+    IssueManagerRunID:
+      name: runID
+      in: path
+      required: true
+      schema:
+        type: string
+        minLength: 1
+    IssueManagerContextRefID:
+      name: contextRefID
+      in: path
+      required: true
+      schema:
+        type: string
+        minLength: 1
+    IssueManagerPageSize:
+      name: pageSize
+      in: query
+      required: false
+      schema:
+        type: integer
+        minimum: 1
+        maximum: 50
+        default: 25
+    IssueManagerPageToken:
+      name: pageToken
+      in: query
+      required: false
+      schema:
+        type: string
+    IssueManagerStatusFilter:
+      name: statusFilter
+      in: query
+      required: false
+      schema:
+        $ref: "#/components/schemas/IssueManagerStatusFilter"
+    IssueManagerSearchQuery:
+      name: searchQuery
+      in: query
+      required: false
+      schema:
+        type: string
+  responses:
+    WorkspaceIssueResourceNotFoundError:
+      description: Workspace issue-manager resource was not found
+      content:
+        application/json:
+          schema:
+            $ref: "#/components/schemas/ApiErrorResponse"
+          examples:
+            workspaceIssueResourceNotFound:
+              value:
+                error:
+                  code: workspace_issue_resource_not_found
+                  reason: workspace_issue_not_found
+                  developerMessage: workspace issue-manager resource not found
+    WorkspaceIssueResourceExistsError:
+      description: Workspace issue-manager resource already exists
+      content:
+        application/json:
+          schema:
+            $ref: "#/components/schemas/ApiErrorResponse"
+          examples:
+            workspaceIssueResourceExists:
+              value:
+                error:
+                  code: workspace_issue_resource_exists
+                  reason: workspace_issue_resource_exists
+                  developerMessage: workspace issue-manager resource already exists
+  schemas:
+    IssueManagerStatus:
+      type: string
+      enum:
+        - not_started
+        - running
+        - in_progress
+        - pending_acceptance
+        - completed
+        - failed
+        - canceled
+    IssueManagerStatusFilter:
+      type: string
+      enum:
+        - all
+        - not_started
+        - running
+        - in_progress
+        - pending_acceptance
+        - completed
+        - failed
+        - canceled
+    IssueManagerRunCompletionStatus:
+      type: string
+      enum:
+        - completed
+        - failed
+        - canceled
+    IssueManagerPriority:
+      type: string
+      enum:
+        - high
+        - medium
+        - low
+      x-enum-varnames:
+        - IssueManagerPriorityHigh
+        - IssueManagerPriorityMedium
+        - IssueManagerPriorityLow
+    IssueManagerStatusCounts:
+      type: object
+      additionalProperties: false
+      required:
+        - all
+        - notStarted
+        - running
+        - pendingAcceptance
+        - completed
+        - failed
+        - canceled
+      properties:
+        all:
+          type: integer
+          minimum: 0
+        notStarted:
+          type: integer
+          minimum: 0
+        running:
+          type: integer
+          minimum: 0
+        pendingAcceptance:
+          type: integer
+          minimum: 0
+        completed:
+          type: integer
+          minimum: 0
+        failed:
+          type: integer
+          minimum: 0
+        canceled:
+          type: integer
+          minimum: 0
+    IssueManagerTopic:
+      type: object
+      additionalProperties: false
+      required:
+        - topicId
+        - workspaceId
+        - title
+        - summary
+        - isDefault
+        - pinnedAtUnix
+        - lastActivityAtUnix
+        - createdAtUnix
+        - updatedAtUnix
+      properties:
+        topicId:
+          type: string
+        workspaceId:
+          type: string
+        title:
+          type: string
+        summary:
+          type: string
+        isDefault:
+          type: boolean
+        pinnedAtUnix:
+          type: integer
+          format: int64
+          minimum: 0
+        lastActivityAtUnix:
+          type: integer
+          format: int64
+          minimum: 0
+        createdAtUnix:
+          type: integer
+          format: int64
+          minimum: 0
+        updatedAtUnix:
+          type: integer
+          format: int64
+          minimum: 0
+    IssueManagerIssue:
+      type: object
+      additionalProperties: false
+      required:
+        - issueId
+        - workspaceId
+        - topicId
+        - title
+        - content
+        - status
+        - taskCount
+        - notStartedCount
+        - runningCount
+        - pendingAcceptanceCount
+        - completedCount
+        - failedCount
+        - canceledCount
+        - creatorUserId
+        - creatorDisplayName
+        - creatorAvatarUrl
+        - createdAtUnix
+        - updatedAtUnix
+      properties:
+        issueId:
+          type: string
+        workspaceId:
+          type: string
+        topicId:
+          type: string
+        title:
+          type: string
+        content:
+          type: string
+        status:
+          $ref: "#/components/schemas/IssueManagerStatus"
+        taskCount:
+          type: integer
+          minimum: 0
+        notStartedCount:
+          type: integer
+          minimum: 0
+        runningCount:
+          type: integer
+          minimum: 0
+        pendingAcceptanceCount:
+          type: integer
+          minimum: 0
+        completedCount:
+          type: integer
+          minimum: 0
+        failedCount:
+          type: integer
+          minimum: 0
+        canceledCount:
+          type: integer
+          minimum: 0
+        creatorUserId:
+          type: string
+        creatorDisplayName:
+          type: string
+        creatorAvatarUrl:
+          type: string
+        createdAtUnix:
+          type: integer
+          format: int64
+          minimum: 0
+        updatedAtUnix:
+          type: integer
+          format: int64
+          minimum: 0
+    IssueManagerTask:
+      type: object
+      additionalProperties: false
+      required:
+        - taskId
+        - issueId
+        - workspaceId
+        - title
+        - content
+        - status
+        - priority
+        - sortIndex
+        - dueAtUnix
+        - creatorUserId
+        - creatorDisplayName
+        - creatorAvatarUrl
+        - latestRunId
+        - createdAtUnix
+        - updatedAtUnix
+      properties:
+        taskId:
+          type: string
+        issueId:
+          type: string
+        workspaceId:
+          type: string
+        title:
+          type: string
+        content:
+          type: string
+        status:
+          $ref: "#/components/schemas/IssueManagerStatus"
+        priority:
+          $ref: "#/components/schemas/IssueManagerPriority"
+        sortIndex:
+          type: integer
+          minimum: 0
+        dueAtUnix:
+          type: integer
+          format: int64
+          minimum: 0
+        creatorUserId:
+          type: string
+        creatorDisplayName:
+          type: string
+        creatorAvatarUrl:
+          type: string
+        latestRunId:
+          type: string
+        createdAtUnix:
+          type: integer
+          format: int64
+          minimum: 0
+        updatedAtUnix:
+          type: integer
+          format: int64
+          minimum: 0
+    IssueManagerRun:
+      type: object
+      additionalProperties: false
+      required:
+        - runId
+        - issueId
+        - workspaceId
+        - requesterUserId
+        - agentUserId
+        - agentSessionId
+        - agentProvider
+        - status
+        - summary
+        - errorMessage
+        - outputDir
+        - executionDirectory
+        - createdAtUnix
+        - startedAtUnix
+        - completedAtUnix
+        - updatedAtUnix
+      properties:
+        runId:
+          type: string
+        taskId:
+          type: string
+        issueId:
+          type: string
+        workspaceId:
+          type: string
+        requesterUserId:
+          type: string
+        agentUserId:
+          type: string
+        agentSessionId:
+          type: string
+        agentProvider:
+          type: string
+        status:
+          $ref: "#/components/schemas/IssueManagerStatus"
+        summary:
+          type: string
+        errorMessage:
+          type: string
+        outputDir:
+          type: string
+        executionDirectory:
+          type: string
+        createdAtUnix:
+          type: integer
+          format: int64
+          minimum: 0
+        startedAtUnix:
+          type: integer
+          format: int64
+          minimum: 0
+        completedAtUnix:
+          type: integer
+          format: int64
+          minimum: 0
+        updatedAtUnix:
+          type: integer
+          format: int64
+          minimum: 0
+    IssueManagerRunOutput:
+      type: object
+      additionalProperties: false
+      required:
+        - outputId
+        - runId
+        - issueId
+        - workspaceId
+        - path
+        - displayName
+        - mediaType
+        - sizeBytes
+        - createdAtUnix
+      properties:
+        outputId:
+          type: string
+        runId:
+          type: string
+        taskId:
+          type: string
+        issueId:
+          type: string
+        workspaceId:
+          type: string
+        path:
+          type: string
+        displayName:
+          type: string
+        mediaType:
+          type: string
+        sizeBytes:
+          type: integer
+          format: int64
+          minimum: 0
+        createdAtUnix:
+          type: integer
+          format: int64
+          minimum: 0
+    IssueManagerContextRef:
+      oneOf:
+        - $ref: "#/components/schemas/IssueManagerIssueContextRef"
+        - $ref: "#/components/schemas/IssueManagerTaskContextRef"
+      discriminator:
+        propertyName: parentKind
+        mapping:
+          issue: "#/components/schemas/IssueManagerIssueContextRef"
+          task: "#/components/schemas/IssueManagerTaskContextRef"
+    IssueManagerIssueContextRef:
+      type: object
+      additionalProperties: false
+      required:
+        - contextRefId
+        - workspaceId
+        - issueId
+        - parentKind
+        - refType
+        - path
+        - displayName
+        - createdAtUnix
+      properties:
+        contextRefId:
+          type: string
+        workspaceId:
+          type: string
+        issueId:
+          type: string
+        parentKind:
+          type: string
+          enum:
+            - issue
+          x-enum-varnames:
+            - IssueManagerIssueContextRefParentKindIssue
+        refType:
+          type: string
+        path:
+          type: string
+        displayName:
+          type: string
+        createdAtUnix:
+          type: integer
+          format: int64
+          minimum: 0
+    IssueManagerTaskContextRef:
+      type: object
+      additionalProperties: false
+      required:
+        - contextRefId
+        - workspaceId
+        - issueId
+        - taskId
+        - parentKind
+        - refType
+        - path
+        - displayName
+        - createdAtUnix
+      properties:
+        contextRefId:
+          type: string
+        workspaceId:
+          type: string
+        issueId:
+          type: string
+        taskId:
+          type: string
+        parentKind:
+          type: string
+          enum:
+            - task
+          x-enum-varnames:
+            - IssueManagerTaskContextRefParentKindTask
+        refType:
+          type: string
+        path:
+          type: string
+        displayName:
+          type: string
+        createdAtUnix:
+          type: integer
+          format: int64
+          minimum: 0
+    IssueManagerIssueResponse:
+      type: object
+      additionalProperties: false
+      required:
+        - issue
+      properties:
+        issue:
+          $ref: "#/components/schemas/IssueManagerIssue"
+    IssueManagerTopicResponse:
+      type: object
+      additionalProperties: false
+      required:
+        - topic
+      properties:
+        topic:
+          $ref: "#/components/schemas/IssueManagerTopic"
+    IssueManagerTopicListResponse:
+      type: object
+      additionalProperties: false
+      required:
+        - topics
+      properties:
+        topics:
+          type: array
+          items:
+            $ref: "#/components/schemas/IssueManagerTopic"
+    IssueManagerIssueListResponse:
+      type: object
+      additionalProperties: false
+      required:
+        - issues
+        - totalCount
+        - statusCounts
+      properties:
+        issues:
+          type: array
+          items:
+            $ref: "#/components/schemas/IssueManagerIssue"
+        nextPageToken:
+          type: string
+        totalCount:
+          type: integer
+          minimum: 0
+        statusCounts:
+          $ref: "#/components/schemas/IssueManagerStatusCounts"
+    IssueManagerIssueDetailResponse:
+      type: object
+      additionalProperties: false
+      required:
+        - issue
+        - tasks
+        - contextRefs
+        - latestRun
+        - recentRuns
+        - latestOutputs
+      properties:
+        issue:
+          $ref: "#/components/schemas/IssueManagerIssue"
+        tasks:
+          type: array
+          items:
+            $ref: "#/components/schemas/IssueManagerTask"
+        contextRefs:
+          type: array
+          items:
+            $ref: "#/components/schemas/IssueManagerContextRef"
+        latestRun:
+          allOf:
+            - $ref: "#/components/schemas/IssueManagerRun"
+          nullable: true
+        recentRuns:
+          type: array
+          items:
+            $ref: "#/components/schemas/IssueManagerRun"
+        latestOutputs:
+          type: array
+          items:
+            $ref: "#/components/schemas/IssueManagerRunOutput"
+    IssueManagerTaskResponse:
+      type: object
+      additionalProperties: false
+      required:
+        - task
+      properties:
+        task:
+          $ref: "#/components/schemas/IssueManagerTask"
+    IssueManagerTaskListResponse:
+      type: object
+      additionalProperties: false
+      required:
+        - tasks
+        - totalCount
+        - statusCounts
+      properties:
+        tasks:
+          type: array
+          items:
+            $ref: "#/components/schemas/IssueManagerTask"
+        nextPageToken:
+          type: string
+        totalCount:
+          type: integer
+          minimum: 0
+        statusCounts:
+          $ref: "#/components/schemas/IssueManagerStatusCounts"
+    IssueManagerTaskDetailResponse:
+      type: object
+      additionalProperties: false
+      required:
+        - task
+        - contextRefs
+        - latestRun
+        - recentRuns
+        - latestOutputs
+      properties:
+        task:
+          $ref: "#/components/schemas/IssueManagerTask"
+        contextRefs:
+          type: array
+          items:
+            $ref: "#/components/schemas/IssueManagerContextRef"
+        latestRun:
+          allOf:
+            - $ref: "#/components/schemas/IssueManagerRun"
+          nullable: true
+        recentRuns:
+          type: array
+          items:
+            $ref: "#/components/schemas/IssueManagerRun"
+        latestOutputs:
+          type: array
+          items:
+            $ref: "#/components/schemas/IssueManagerRunOutput"
+    IssueManagerRunResponse:
+      type: object
+      additionalProperties: false
+      required:
+        - run
+      properties:
+        run:
+          $ref: "#/components/schemas/IssueManagerRun"
+    IssueManagerRunListResponse:
+      type: object
+      additionalProperties: false
+      required:
+        - runs
+      properties:
+        runs:
+          type: array
+          items:
+            $ref: "#/components/schemas/IssueManagerRun"
+    IssueManagerRunEnvelope:
+      type: object
+      additionalProperties: false
+      required:
+        - run
+        - outputs
+      properties:
+        run:
+          $ref: "#/components/schemas/IssueManagerRun"
+        outputs:
+          type: array
+          items:
+            $ref: "#/components/schemas/IssueManagerRunOutput"
+    IssueManagerContextRefsResponse:
+      type: object
+      additionalProperties: false
+      required:
+        - contextRefs
+      properties:
+        contextRefs:
+          type: array
+          items:
+            $ref: "#/components/schemas/IssueManagerContextRef"
+    CreateIssueManagerIssueRequest:
+      type: object
+      additionalProperties: false
+      required:
+        - topicId
+        - title
+      properties:
+        issueId:
+          type: string
+        topicId:
+          type: string
+          minLength: 1
+        title:
+          type: string
+          minLength: 1
+        content:
+          type: string
+    CreateIssueManagerTopicRequest:
+      type: object
+      additionalProperties: false
+      required:
+        - title
+      properties:
+        topicId:
+          type: string
+        title:
+          type: string
+          minLength: 1
+        summary:
+          type: string
+    UpdateIssueManagerTopicRequest:
+      type: object
+      additionalProperties: false
+      properties:
+        title:
+          type: string
+        summary:
+          type: string
+        pinned:
+          type: boolean
+    UpdateIssueManagerIssueRequest:
+      type: object
+      additionalProperties: false
+      properties:
+        title:
+          type: string
+        content:
+          type: string
+        status:
+          $ref: "#/components/schemas/IssueManagerStatus"
+    CreateIssueManagerTaskRequest:
+      type: object
+      additionalProperties: false
+      required:
+        - title
+      properties:
+        taskId:
+          type: string
+        title:
+          type: string
+          minLength: 1
+        content:
+          type: string
+        priority:
+          $ref: "#/components/schemas/IssueManagerPriority"
+        dueAtUnix:
+          type: integer
+          format: int64
+          minimum: 0
+    UpdateIssueManagerTaskRequest:
+      type: object
+      additionalProperties: false
+      properties:
+        title:
+          type: string
+        content:
+          type: string
+        status:
+          $ref: "#/components/schemas/IssueManagerStatus"
+        priority:
+          $ref: "#/components/schemas/IssueManagerPriority"
+        dueAtUnix:
+          type: integer
+          format: int64
+          minimum: 0
+    AddIssueManagerContextRefItem:
+      type: object
+      additionalProperties: false
+      required:
+        - refType
+        - path
+      properties:
+        refType:
+          type: string
+        path:
+          type: string
+          minLength: 1
+        displayName:
+          type: string
+        contextRefId:
+          type: string
+    AddIssueManagerContextRefsRequest:
+      type: object
+      additionalProperties: false
+      required:
+        - refs
+      properties:
+        refs:
+          type: array
+          items:
+            $ref: "#/components/schemas/AddIssueManagerContextRefItem"
+    CreateIssueManagerRunRequest:
+      type: object
+      additionalProperties: false
+      required:
+        - agentProvider
+      properties:
+        runId:
+          type: string
+        agentProvider:
+          type: string
+          minLength: 1
+        agentUserId:
+          type: string
+        agentSessionId:
+          type: string
+        executionDirectory:
+          type: string
+    CompleteIssueManagerRunOutputItem:
+      type: object
+      additionalProperties: false
+      required:
+        - path
+      properties:
+        outputId:
+          type: string
+        path:
+          type: string
+          minLength: 1
+        displayName:
+          type: string
+        mediaType:
+          type: string
+        sizeBytes:
+          type: integer
+          format: int64
+          minimum: 0
+    CompleteIssueManagerRunRequest:
+      type: object
+      additionalProperties: false
+      required:
+        - status
+        - outputs
+      properties:
+        status:
+          $ref: "#/components/schemas/IssueManagerRunCompletionStatus"
+        summary:
+          type: string
+        errorMessage:
+          type: string
+        outputs:
+          type: array
+          items:
+            $ref: "#/components/schemas/CompleteIssueManagerRunOutputItem"
+    DeleteIssueManagerIssueResponse:
+      type: object
+      additionalProperties: false
+      required:
+        - removed
+      properties:
+        removed:
+          type: boolean
+    DeleteIssueManagerTopicResponse:
+      type: object
+      additionalProperties: false
+      required:
+        - removed
+      properties:
+        removed:
+          type: boolean
+    DeleteIssueManagerTaskResponse:
+      type: object
+      additionalProperties: false
+      required:
+        - removed
+      properties:
+        removed:
+          type: boolean
+    DeleteIssueManagerContextRefResponse:
+      type: object
+      additionalProperties: false
+      required:
+        - removed
+      properties:
+        removed:
+          type: boolean