@agentmc/api 0.1.1

package/docs/operations/listTaskComments.md

@@ -0,0 +1,170 @@
+# listTaskComments
+
+- Method: `GET`
+- Path: `/tasks/{task}/comments`
+- Summary: List comments on one task.
+- Auth: ApiKeyAuth OR AgentBearerAuth OR BearerAuth
+
+## Description
+
+No additional description.
+
+## Parameters
+
+| Name | In | Required | Description | Example |
+| --- | --- | --- | --- | --- |
+| task | path | yes | Task identifier. | 1 |
+| per_page | query | no | Page size for paginated responses. | 25 |
+
+## Request Example
+
+None.
+
+## Success Responses
+
+### 200 (application/json)
+Task comments returned.
+
+```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"
+    }
+  ],
+  "links": {
+    "first": "example",
+    "last": "example",
+    "prev": "example",
+    "next": "example"
+  },
+  "meta": {
+    "current_page": 1,
+    "from": 1,
+    "last_page": 1,
+    "links": [
+      {
+        "url": "https://agentmc.example.com/docs/incident-123",
+        "label": "example",
+        "active": true
+      }
+    ],
+    "path": "example",
+    "per_page": 25,
+    "total": 0
+  }
+}
+```
+
+
+## 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."
+        ]
+      }
+    }
+  }
+}
+```
+
+
+## SDK Example
+
+```ts
+import { AgentMCApi } from "@agentmc/api";
+
+const client = new AgentMCApi({
+  agentToken: process.env.AGENTMC_AGENT_TOKEN
+});
+
+const result = await client.operations.listTaskComments({
+  "params": {
+    "path": {
+      "task": 1
+    },
+    "query": {
+      "per_page": 25
+    }
+  }
+});
+
+if (result.error) {
+  console.error(result.status, result.error);
+} else {
+  console.log(result.data);
+}
+```
+
+## cURL Example
+
+```bash
+curl -X GET "https://agentmc.ai/api/v1/tasks/1/comments?per_page=25" \\
+  -H "Accept: application/json" \\
+  -H "X-Api-Key: $AGENTMC_API_KEY"
+```

package/docs/operations/listTasks.md

@@ -0,0 +1,158 @@
+# listTasks
+
+- Method: `GET`
+- Path: `/tasks`
+- Summary: List board tasks.
+- Auth: ApiKeyAuth OR AgentBearerAuth OR BearerAuth
+
+## Description
+
+No additional description.
+
+## Parameters
+
+| Name | In | Required | Description | Example |
+| --- | --- | --- | --- | --- |
+| board_id | query | no | Board identifier. | 42 |
+| status | query | no | Current lifecycle status for this record. | "online" |
+| assigned_to_user_id | query | no | Identifier for assigned to user. | 42 |
+| assigned_to_agent | query | no | Assigned to agent. | 1 |
+| agent_id | query | no | Identifier for agent. | 42 |
+| due_from | query | no | Due from. | "2026-02-22T17:21:00Z" |
+| due_to | query | no | Due to. | "2026-02-22T17:21:00Z" |
+| per_page | query | no | Page size for paginated responses. | 25 |
+
+## Request Example
+
+None.
+
+## Success Responses
+
+### 200 (application/json)
+Task list returned.
+
+```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"
+    }
+  ],
+  "links": {
+    "first": "example",
+    "last": "example",
+    "prev": "example",
+    "next": "example"
+  },
+  "meta": {
+    "current_page": 1,
+    "from": 1,
+    "last_page": 1,
+    "links": [
+      {
+        "url": "https://agentmc.example.com/docs/incident-123",
+        "label": "example",
+        "active": true
+      }
+    ],
+    "path": "example",
+    "per_page": 25,
+    "total": 0
+  }
+}
+```
+
+
+## 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."
+        ]
+      }
+    }
+  }
+}
+```
+
+
+## SDK Example
+
+```ts
+import { AgentMCApi } from "@agentmc/api";
+
+const client = new AgentMCApi({
+  agentToken: process.env.AGENTMC_AGENT_TOKEN
+});
+
+const result = await client.operations.listTasks({
+  "params": {
+    "query": {
+      "board_id": 42,
+      "status": "online",
+      "assigned_to_user_id": 42,
+      "assigned_to_agent": 1,
+      "agent_id": 42,
+      "due_from": "2026-02-22T17:21:00Z",
+      "due_to": "2026-02-22T17:21:00Z",
+      "per_page": 25
+    }
+  }
+});
+
+if (result.error) {
+  console.error(result.status, result.error);
+} else {
+  console.log(result.data);
+}
+```
+
+## cURL Example
+
+```bash
+curl -X GET "https://agentmc.ai/api/v1/tasks?board_id=42&status=online&assigned_to_user_id=42&assigned_to_agent=1&agent_id=42&due_from=2026-02-22T17%3A21%3A00Z&due_to=2026-02-22T17%3A21%3A00Z&per_page=25" \\
+  -H "Accept: application/json" \\
+  -H "X-Api-Key: $AGENTMC_API_KEY"
+```

package/docs/operations/listTeamMembers.md

@@ -0,0 +1,137 @@
+# listTeamMembers
+
+- Method: `GET`
+- Path: `/team/members`
+- Summary: List users for the current workspace team.
+- Auth: ApiKeyAuth OR AgentBearerAuth OR BearerAuth
+
+## Description
+
+No additional description.
+
+## Parameters
+
+| Name | In | Required | Description | Example |
+| --- | --- | --- | --- | --- |
+| per_page | query | no | Page size for paginated responses. | 25 |
+| search | query | no | Case-insensitive text search query. | "operations" |
+
+## Request Example
+
+None.
+
+## Success Responses
+
+### 200 (application/json)
+Users returned.
+
+```json
+{
+  "data": [
+    {
+      "id": 42,
+      "name": "Example Name",
+      "email": "agent@example.com",
+      "assignee_type": "human",
+      "team_role": "example",
+      "is_owner": true
+    }
+  ],
+  "links": {
+    "first": "example",
+    "last": "example",
+    "prev": "example",
+    "next": "example"
+  },
+  "meta": {
+    "current_page": 1,
+    "from": 1,
+    "last_page": 1,
+    "links": [
+      {
+        "url": "https://agentmc.example.com/docs/incident-123",
+        "label": "example",
+        "active": true
+      }
+    ],
+    "path": "example",
+    "per_page": 25,
+    "total": 0
+  }
+}
+```
+
+
+## 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."
+        ]
+      }
+    }
+  }
+}
+```
+
+
+## SDK Example
+
+```ts
+import { AgentMCApi } from "@agentmc/api";
+
+const client = new AgentMCApi({
+  agentToken: process.env.AGENTMC_AGENT_TOKEN
+});
+
+const result = await client.operations.listTeamMembers({
+  "params": {
+    "query": {
+      "per_page": 25,
+      "search": "operations"
+    }
+  }
+});
+
+if (result.error) {
+  console.error(result.status, result.error);
+} else {
+  console.log(result.data);
+}
+```
+
+## cURL Example
+
+```bash
+curl -X GET "https://agentmc.ai/api/v1/team/members?per_page=25&search=operations" \\
+  -H "Accept: application/json" \\
+  -H "X-Api-Key: $AGENTMC_API_KEY"
+```

package/docs/operations/markAllNotificationsRead.md

@@ -0,0 +1,107 @@
+# markAllNotificationsRead
+
+- Method: `POST`
+- Path: `/notifications/read-all`
+- Summary: Mark all unread workspace notifications as read for the current workspace.
+- Auth: ApiKeyAuth OR AgentBearerAuth OR BearerAuth
+
+## Description
+
+No additional description.
+
+## Parameters
+
+None.
+
+## Request Example
+
+### application/json
+```json
+{}
+```
+
+## Success Responses
+
+### 200 (application/json)
+Notifications updated.
+
+```json
+{
+  "data": {
+    "updated": 4,
+    "unread_count": 0
+  }
+}
+```
+
+
+## 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."
+        ]
+      }
+    }
+  }
+}
+```
+
+
+## SDK Example
+
+```ts
+import { AgentMCApi } from "@agentmc/api";
+
+const client = new AgentMCApi({
+  agentToken: process.env.AGENTMC_AGENT_TOKEN
+});
+
+const result = await client.operations.markAllNotificationsRead({
+  "body": {}
+});
+
+if (result.error) {
+  console.error(result.status, result.error);
+} else {
+  console.log(result.data);
+}
+```
+
+## cURL Example
+
+```bash
+curl -X POST "https://agentmc.ai/api/v1/notifications/read-all" \\
+  -H "Accept: application/json" \\
+  -H "X-Api-Key: $AGENTMC_API_KEY" \\
+  -H "Content-Type: application/json" \\
+  --data-raw "{}"
+```