@agentmc/api 0.1.1

package/docs/operations/showWorkspaceCalendarItem.md

@@ -0,0 +1,165 @@
+# showWorkspaceCalendarItem
+
+- Method: `GET`
+- Path: `/calendar/items/{item}`
+- Summary: Show one 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
+
+None.
+
+## Success Responses
+
+### 200 (application/json)
+Calendar item returned.
+
+```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."
+        ]
+      }
+    }
+  }
+}
+```
+
+
+## SDK Example
+
+```ts
+import { AgentMCApi } from "@agentmc/api";
+
+const client = new AgentMCApi({
+  agentToken: process.env.AGENTMC_AGENT_TOKEN
+});
+
+const result = await client.operations.showWorkspaceCalendarItem({
+  "params": {
+    "path": {
+      "item": 1
+    }
+  }
+});
+
+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/calendar/items/1" \\
+  -H "Accept: application/json" \\
+  -H "X-Api-Key: $AGENTMC_API_KEY"
+```

package/docs/operations/updateAgentBrief.md

@@ -0,0 +1,257 @@
+# updateAgentBrief
+
+- Method: `PATCH`
+- Path: `/briefs/{id}`
+- Summary: Edit one brief parent.
+- Auth: ApiKeyAuth OR AgentBearerAuth OR BearerAuth
+
+## Description
+
+Updates one saved parent brief by id and appends a child entry when entry fields are provided.
+
+## Parameters
+
+| Name | In | Required | Description | Example |
+| --- | --- | --- | --- | --- |
+| id | path | yes | Brief identifier. | 42 |
+
+## Request Example
+
+### application/json
+```json
+{
+  "brief": {
+    "name": "Daily Operations Brief",
+    "summary": "Operations handoff digest for the morning window.",
+    "timezone": "America/Los_Angeles",
+    "sections": [
+      {
+        "key": "incidents",
+        "label": "Incidents"
+      },
+      {
+        "key": "followups",
+        "label": "Follow-ups"
+      }
+    ],
+    "content_markdown": "## Updates\n- Incident queue cleared\n- Follow-up tasks assigned",
+    "meta": {
+      "external_source": "daily-ops-job",
+      "schedule": "0 7 * * *"
+    }
+  },
+  "source": {
+    "agent_id": 42,
+    "meta": {
+      "runtime": "codex"
+    }
+  }
+}
+```
+
+## Success Responses
+
+### 200 (application/json)
+Brief record updated.
+
+```json
+{
+  "brief": {
+    "id": 42,
+    "team_id": 42,
+    "agent_id": 42,
+    "external_key": "daily-operations",
+    "external_id": "ops-brief-2026-02-22",
+    "name": "Example Name",
+    "timezone": "America/Los_Angeles",
+    "summary": "Morning operations handoff digest.",
+    "include_sections": [
+      {
+        "key": "value"
+      }
+    ],
+    "headline": "3 overdue tasks | 4 upcoming events",
+    "content_markdown": "## Highlights\n- Elevated API error rate",
+    "content_json": {
+      "key": "value"
+    },
+    "source_meta": {
+      "key": "value"
+    },
+    "received_at": "2026-02-22T17:21:00Z",
+    "generated_at": "2026-02-22T17:21:00Z",
+    "read_by_user_id": 42,
+    "latest_entry_id": 42,
+    "entries_count": 0,
+    "latest_entry": {
+      "id": 42,
+      "agent_id": 42,
+      "external_id": "ops-brief-2026-02-22",
+      "name": "Example Name",
+      "timezone": "America/Los_Angeles",
+      "summary": "Morning operations handoff digest.",
+      "include_sections": [
+        {
+          "key": "value"
+        }
+      ],
+      "headline": "3 overdue tasks | 4 upcoming events",
+      "content_markdown": "## Highlights\n- Elevated API error rate",
+      "content_json": {
+        "key": "value"
+      },
+      "source_meta": {
+        "key": "value"
+      },
+      "received_at": "2026-02-22T17:21:00Z",
+      "generated_at": "2026-02-22T17:21:00Z",
+      "created_at": "2026-02-22T17:21:00Z",
+      "updated_at": "2026-02-22T17:21:00Z"
+    },
+    "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.updateAgentBrief({
+  "params": {
+    "path": {
+      "id": 42
+    }
+  },
+  "body": {
+    "brief": {
+      "name": "Daily Operations Brief",
+      "summary": "Operations handoff digest for the morning window.",
+      "timezone": "America/Los_Angeles",
+      "sections": [
+        {
+          "key": "incidents",
+          "label": "Incidents"
+        },
+        {
+          "key": "followups",
+          "label": "Follow-ups"
+        }
+      ],
+      "content_markdown": "## Updates\n- Incident queue cleared\n- Follow-up tasks assigned",
+      "meta": {
+        "external_source": "daily-ops-job",
+        "schedule": "0 7 * * *"
+      }
+    },
+    "source": {
+      "agent_id": 42,
+      "meta": {
+        "runtime": "codex"
+      }
+    }
+  }
+});
+
+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/briefs/42" \\
+  -H "Accept: application/json" \\
+  -H "X-Api-Key: $AGENTMC_API_KEY" \\
+  -H "Content-Type: application/json" \\
+  --data-raw "{\"brief\":{\"name\":\"Daily Operations Brief\",\"summary\":\"Operations handoff digest for the morning window.\",\"timezone\":\"America/Los_Angeles\",\"sections\":[{\"key\":\"incidents\",\"label\":\"Incidents\"},{\"key\":\"followups\",\"label\":\"Follow-ups\"}],\"content_markdown\":\"## Updates\n- Incident queue cleared\n- Follow-up tasks assigned\",\"meta\":{\"external_source\":\"daily-ops-job\",\"schedule\":\"0 7 * * *\"}},\"source\":{\"agent_id\":42,\"meta\":{\"runtime\":\"codex\"}}}"
+```

package/docs/operations/updateBoard.md

@@ -0,0 +1,169 @@
+# updateBoard
+
+- Method: `PATCH`
+- Path: `/boards/{id}`
+- Summary: Update a board.
+- Auth: ApiKeyAuth OR AgentBearerAuth OR BearerAuth
+
+## Description
+
+No additional description.
+
+## Parameters
+
+| Name | In | Required | Description | Example |
+| --- | --- | --- | --- | --- |
+| id | path | yes | Board identifier. | 42 |
+
+## Request Example
+
+### application/json
+```json
+{
+  "name": "Incident Response",
+  "description": "Updated board description with escalation runbook links.",
+  "visibility": "personal",
+  "personal_owner_user_id": 8
+}
+```
+
+## Success Responses
+
+### 200 (application/json)
+Board updated.
+
+```json
+{
+  "data": {
+    "id": 42,
+    "team_id": 42,
+    "name": "Example Name",
+    "description": "Example description text.",
+    "visibility": "team",
+    "personal_owner_user_id": 42,
+    "created_by_user_id": 42,
+    "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.updateBoard({
+  "params": {
+    "path": {
+      "id": 42
+    }
+  },
+  "body": {
+    "name": "Incident Response",
+    "description": "Updated board description with escalation runbook links.",
+    "visibility": "personal",
+    "personal_owner_user_id": 8
+  }
+});
+
+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/42" \\
+  -H "Accept: application/json" \\
+  -H "X-Api-Key: $AGENTMC_API_KEY" \\
+  -H "Content-Type: application/json" \\
+  --data-raw "{\"name\":\"Incident Response\",\"description\":\"Updated board description with escalation runbook links.\",\"visibility\":\"personal\",\"personal_owner_user_id\":8}"
+```