@agentmc/api 0.1.1

package/docs/operations/updateBoardColumn.md

@@ -0,0 +1,165 @@
+# updateBoardColumn
+
+- Method: `PATCH`
+- Path: `/boards/{board}/columns`
+- Summary: Update one or more board columns.
+- Auth: ApiKeyAuth OR AgentBearerAuth OR BearerAuth
+
+## Description
+
+No additional description.
+
+## Parameters
+
+| Name | In | Required | Description | Example |
+| --- | --- | --- | --- | --- |
+| board | path | yes | Board identifier. | 1 |
+
+## Request Example
+
+### application/json
+```json
+{
+  "column_id": 13,
+  "name": "Review",
+  "position": 3
+}
+```
+
+## Success Responses
+
+### 200 (application/json)
+Columns updated.
+
+```json
+{
+  "data": {
+    "id": 42,
+    "board_id": 42,
+    "team_id": 42,
+    "name": "Example Name",
+    "position": 1,
+    "created_at": "2026-02-22T17:21:00Z",
+    "updated_at": "2026-02-22T17:21:00Z"
+  }
+}
+```
+
+
+## Error Responses
+
+### 401 (application/json)
+Missing or invalid credentials.
+
+```json
+{
+  "error": {
+    "code": "validation.failed",
+    "message": "Validation failed.",
+    "details": {
+      "fields": {
+        "title": [
+          "The title field is required."
+        ]
+      }
+    }
+  }
+}
+```
+
+### 403 (application/json)
+Forbidden.
+
+```json
+{
+  "error": {
+    "code": "validation.failed",
+    "message": "Validation failed.",
+    "details": {
+      "fields": {
+        "title": [
+          "The title field is required."
+        ]
+      }
+    }
+  }
+}
+```
+
+### 404 (application/json)
+Resource not found.
+
+```json
+{
+  "error": {
+    "code": "validation.failed",
+    "message": "Validation failed.",
+    "details": {
+      "fields": {
+        "title": [
+          "The title field is required."
+        ]
+      }
+    }
+  }
+}
+```
+
+### 422 (application/json)
+Validation failed.
+
+```json
+{
+  "error": {
+    "code": "validation.failed",
+    "message": "Validation failed.",
+    "details": {
+      "fields": {
+        "title": [
+          "The title field is required."
+        ]
+      }
+    }
+  }
+}
+```
+
+
+## SDK Example
+
+```ts
+import { AgentMCApi } from "@agentmc/api";
+
+const client = new AgentMCApi({
+  agentToken: process.env.AGENTMC_AGENT_TOKEN
+});
+
+const result = await client.operations.updateBoardColumn({
+  "params": {
+    "path": {
+      "board": 1
+    }
+  },
+  "body": {
+    "column_id": 13,
+    "name": "Review",
+    "position": 3
+  }
+});
+
+if (result.error) {
+  console.error(result.status, result.error);
+} else {
+  console.log(result.data);
+}
+```
+
+## cURL Example
+
+```bash
+curl -X PATCH "https://agentmc.ai/api/v1/boards/1/columns" \\
+  -H "Accept: application/json" \\
+  -H "X-Api-Key: $AGENTMC_API_KEY" \\
+  -H "Content-Type: application/json" \\
+  --data-raw "{\"column_id\":13,\"name\":\"Review\",\"position\":3}"
+```

package/docs/operations/updateTask.md

@@ -0,0 +1,175 @@
+# updateTask
+
+- Method: `PATCH`
+- Path: `/tasks/{task}`
+- Summary: Update a task.
+- Auth: ApiKeyAuth OR AgentBearerAuth OR BearerAuth
+
+## Description
+
+No additional description.
+
+## Parameters
+
+| Name | In | Required | Description | Example |
+| --- | --- | --- | --- | --- |
+| task | path | yes | Task identifier. | 1 |
+
+## Request Example
+
+### application/json
+```json
+{
+  "title": "Draft post-incident summary",
+  "status": "review",
+  "due_at": "2026-02-24T19:00:00Z",
+  "assigned_to_agent_id": 42
+}
+```
+
+## Success Responses
+
+### 200 (application/json)
+Task updated.
+
+```json
+{
+  "data": {
+    "id": 42,
+    "team_id": 42,
+    "board_id": 42,
+    "column_id": 42,
+    "title": "Example Title",
+    "description": "Example description text.",
+    "status": "backlog",
+    "position": 1,
+    "due_at": "2026-02-22T17:21:00Z",
+    "created_by_user_id": 42,
+    "assigned_to_user_id": 42,
+    "assigned_to_agent_id": 42,
+    "assignee_type": "human",
+    "created_at": "2026-02-22T17:21:00Z",
+    "updated_at": "2026-02-22T17:21:00Z"
+  }
+}
+```
+
+
+## Error Responses
+
+### 401 (application/json)
+Missing or invalid credentials.
+
+```json
+{
+  "error": {
+    "code": "validation.failed",
+    "message": "Validation failed.",
+    "details": {
+      "fields": {
+        "title": [
+          "The title field is required."
+        ]
+      }
+    }
+  }
+}
+```
+
+### 403 (application/json)
+Forbidden.
+
+```json
+{
+  "error": {
+    "code": "validation.failed",
+    "message": "Validation failed.",
+    "details": {
+      "fields": {
+        "title": [
+          "The title field is required."
+        ]
+      }
+    }
+  }
+}
+```
+
+### 404 (application/json)
+Resource not found.
+
+```json
+{
+  "error": {
+    "code": "validation.failed",
+    "message": "Validation failed.",
+    "details": {
+      "fields": {
+        "title": [
+          "The title field is required."
+        ]
+      }
+    }
+  }
+}
+```
+
+### 422 (application/json)
+Validation failed.
+
+```json
+{
+  "error": {
+    "code": "validation.failed",
+    "message": "Validation failed.",
+    "details": {
+      "fields": {
+        "title": [
+          "The title field is required."
+        ]
+      }
+    }
+  }
+}
+```
+
+
+## SDK Example
+
+```ts
+import { AgentMCApi } from "@agentmc/api";
+
+const client = new AgentMCApi({
+  agentToken: process.env.AGENTMC_AGENT_TOKEN
+});
+
+const result = await client.operations.updateTask({
+  "params": {
+    "path": {
+      "task": 1
+    }
+  },
+  "body": {
+    "title": "Draft post-incident summary",
+    "status": "review",
+    "due_at": "2026-02-24T19:00:00Z",
+    "assigned_to_agent_id": 42
+  }
+});
+
+if (result.error) {
+  console.error(result.status, result.error);
+} else {
+  console.log(result.data);
+}
+```
+
+## cURL Example
+
+```bash
+curl -X PATCH "https://agentmc.ai/api/v1/tasks/1" \\
+  -H "Accept: application/json" \\
+  -H "X-Api-Key: $AGENTMC_API_KEY" \\
+  -H "Content-Type: application/json" \\
+  --data-raw "{\"title\":\"Draft post-incident summary\",\"status\":\"review\",\"due_at\":\"2026-02-24T19:00:00Z\",\"assigned_to_agent_id\":42}"
+```

package/docs/operations/updateTaskComment.md

@@ -0,0 +1,174 @@
+# updateTaskComment
+
+- Method: `PATCH`
+- Path: `/tasks/{task}/comments/{comment}`
+- Summary: Update one existing task comment.
+- Auth: ApiKeyAuth OR AgentBearerAuth OR BearerAuth
+
+## Description
+
+No additional description.
+
+## Parameters
+
+| Name | In | Required | Description | Example |
+| --- | --- | --- | --- | --- |
+| task | path | yes | Task identifier. | 1 |
+| comment | path | yes | Task comment identifier. | 1 |
+
+## Request Example
+
+### application/json
+```json
+{
+  "body": "Updated handoff note with the latest timeline and log links."
+}
+```
+
+## Success Responses
+
+### 200 (application/json)
+Task comment updated.
+
+```json
+{
+  "data": {
+    "id": 42,
+    "task_id": 42,
+    "actor_type": "user",
+    "actor_id": 42,
+    "actor_name": "Example Name",
+    "body": "Example content.",
+    "mentions": [
+      {
+        "key": "example",
+        "type": "user",
+        "id": 42,
+        "label": "example",
+        "handle": "example",
+        "token": "example"
+      }
+    ],
+    "edited_at": "2026-02-22T17:21:00Z",
+    "created_at": "2026-02-22T17:21:00Z"
+  }
+}
+```
+
+
+## Error Responses
+
+### 401 (application/json)
+Missing or invalid credentials.
+
+```json
+{
+  "error": {
+    "code": "validation.failed",
+    "message": "Validation failed.",
+    "details": {
+      "fields": {
+        "title": [
+          "The title field is required."
+        ]
+      }
+    }
+  }
+}
+```
+
+### 403 (application/json)
+Forbidden.
+
+```json
+{
+  "error": {
+    "code": "validation.failed",
+    "message": "Validation failed.",
+    "details": {
+      "fields": {
+        "title": [
+          "The title field is required."
+        ]
+      }
+    }
+  }
+}
+```
+
+### 404 (application/json)
+Resource not found.
+
+```json
+{
+  "error": {
+    "code": "validation.failed",
+    "message": "Validation failed.",
+    "details": {
+      "fields": {
+        "title": [
+          "The title field is required."
+        ]
+      }
+    }
+  }
+}
+```
+
+### 422 (application/json)
+Validation failed.
+
+```json
+{
+  "error": {
+    "code": "validation.failed",
+    "message": "Validation failed.",
+    "details": {
+      "fields": {
+        "title": [
+          "The title field is required."
+        ]
+      }
+    }
+  }
+}
+```
+
+
+## SDK Example
+
+```ts
+import { AgentMCApi } from "@agentmc/api";
+
+const client = new AgentMCApi({
+  agentToken: process.env.AGENTMC_AGENT_TOKEN
+});
+
+const result = await client.operations.updateTaskComment({
+  "params": {
+    "path": {
+      "task": 1,
+      "comment": 1
+    }
+  },
+  "body": {
+    "body": "Updated handoff note with the latest timeline and log links."
+  }
+});
+
+if (result.error) {
+  console.error(result.status, result.error);
+} else {
+  console.log(result.data);
+}
+```
+
+## cURL Example
+
+```bash
+curl -X PATCH "https://agentmc.ai/api/v1/tasks/1/comments/1" \\
+  -H "Accept: application/json" \\
+  -H "X-Api-Key: $AGENTMC_API_KEY" \\
+  -H "Content-Type: application/json" \\
+  --data-raw "{\"body\":\"Updated handoff note with the latest timeline and log links.\"}"
+```

package/docs/operations/updateWorkspaceCalendarItem.md

@@ -0,0 +1,204 @@
+# updateWorkspaceCalendarItem
+
+- Method: `PUT`
+- Path: `/calendar/items/{item}`
+- Summary: Update a calendar item.
+- Auth: ApiKeyAuth OR AgentBearerAuth OR BearerAuth
+
+## Description
+
+No additional description.
+
+## Parameters
+
+| Name | In | Required | Description | Example |
+| --- | --- | --- | --- | --- |
+| item | path | yes | Calendar item identifier. | 1 |
+
+## Request Example
+
+### application/json
+```json
+{
+  "title": "Review outage timeline",
+  "description": "Add links to root-cause analysis notes.",
+  "due_at": "2026-02-24T11:00:00Z",
+  "status": "in_progress",
+  "priority": "urgent",
+  "visibility": "workspace"
+}
+```
+
+## Success Responses
+
+### 200 (application/json)
+Calendar item updated.
+
+```json
+{
+  "data": {
+    "id": 42,
+    "workspace_id": 42,
+    "type": "event",
+    "title": "Example Title",
+    "description": "Example description text.",
+    "start_at": "2026-02-22T17:21:00Z",
+    "end_at": "2026-02-22T17:21:00Z",
+    "due_at": "2026-02-22T17:21:00Z",
+    "all_day": false,
+    "location": "example",
+    "timezone": "America/Los_Angeles",
+    "status": "todo",
+    "priority": "low",
+    "visibility": "workspace",
+    "created_by": 1,
+    "updated_by": 1,
+    "assignees": [
+      {
+        "id": 42,
+        "assignee_type": "user",
+        "assignee_id": 42,
+        "role": "owner",
+        "name": "Example Name",
+        "created_at": "2026-02-22T17:21:00Z"
+      }
+    ],
+    "links": [
+      {
+        "id": 42,
+        "link_type": "example",
+        "link_id": 42,
+        "url": "https://agentmc.example.com/docs/incident-123",
+        "title": "Example Title",
+        "created_at": "2026-02-22T17:21:00Z"
+      }
+    ],
+    "comments_count": 1,
+    "created_at": "2026-02-22T17:21:00Z",
+    "updated_at": "2026-02-22T17:21:00Z",
+    "deleted_at": "2026-02-22T17:21:00Z"
+  }
+}
+```
+
+
+## Error Responses
+
+### 401 (application/json)
+Missing or invalid credentials.
+
+```json
+{
+  "error": {
+    "code": "validation.failed",
+    "message": "Validation failed.",
+    "details": {
+      "fields": {
+        "title": [
+          "The title field is required."
+        ]
+      }
+    }
+  }
+}
+```
+
+### 403 (application/json)
+Forbidden.
+
+```json
+{
+  "error": {
+    "code": "validation.failed",
+    "message": "Validation failed.",
+    "details": {
+      "fields": {
+        "title": [
+          "The title field is required."
+        ]
+      }
+    }
+  }
+}
+```
+
+### 404 (application/json)
+Resource not found.
+
+```json
+{
+  "error": {
+    "code": "validation.failed",
+    "message": "Validation failed.",
+    "details": {
+      "fields": {
+        "title": [
+          "The title field is required."
+        ]
+      }
+    }
+  }
+}
+```
+
+### 422 (application/json)
+Validation failed.
+
+```json
+{
+  "error": {
+    "code": "validation.failed",
+    "message": "Validation failed.",
+    "details": {
+      "fields": {
+        "title": [
+          "The title field is required."
+        ]
+      }
+    }
+  }
+}
+```
+
+
+## SDK Example
+
+```ts
+import { AgentMCApi } from "@agentmc/api";
+
+const client = new AgentMCApi({
+  agentToken: process.env.AGENTMC_AGENT_TOKEN
+});
+
+const result = await client.operations.updateWorkspaceCalendarItem({
+  "params": {
+    "path": {
+      "item": 1
+    }
+  },
+  "body": {
+    "title": "Review outage timeline",
+    "description": "Add links to root-cause analysis notes.",
+    "due_at": "2026-02-24T11:00:00Z",
+    "status": "in_progress",
+    "priority": "urgent",
+    "visibility": "workspace"
+  }
+});
+
+if (result.error) {
+  console.error(result.status, result.error);
+} else {
+  console.log(result.data);
+}
+```
+
+## cURL Example
+
+```bash
+curl -X PUT "https://agentmc.ai/api/v1/calendar/items/1" \\
+  -H "Accept: application/json" \\
+  -H "X-Api-Key: $AGENTMC_API_KEY" \\
+  -H "Content-Type: application/json" \\
+  --data-raw "{\"title\":\"Review outage timeline\",\"description\":\"Add links to root-cause analysis notes.\",\"due_at\":\"2026-02-24T11:00:00Z\",\"status\":\"in_progress\",\"priority\":\"urgent\",\"visibility\":\"workspace\"}"
+```