@agentmc/api 0.2.1 → 0.2.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -4,8 +4,8 @@ Generated from `spec/openapi.filtered.json`.
4
4
 
5
5
  | Operation ID | Method | Path | Tags |
6
6
  | --- | --- | --- | --- |
7
- | [agentConnectedInstructions](./agentConnectedInstructions.md) | GET | `/agents/{agent}/instructions` | Agents |
8
7
  | [agentHeartbeat](./agentHeartbeat.md) | POST | `/agents/{agent}/heartbeat` | Agents |
8
+ | [agentInstructions](./agentInstructions.md) | GET | `/agents/{agent}/agent-instructions` | Agents |
9
9
  | [authenticateAgentRealtimeSocket](./authenticateAgentRealtimeSocket.md) | POST | `/agents/{agent}/realtime/sessions/{session}/socket-auth` | Agents |
10
10
  | [claimAgentRealtimeSession](./claimAgentRealtimeSession.md) | POST | `/agents/{agent}/realtime/sessions/{session}/claim` | Agents |
11
11
  | [closeAgentRealtimeSession](./closeAgentRealtimeSession.md) | POST | `/agents/{agent}/realtime/sessions/{session}/close` | Agents |
@@ -55,16 +55,28 @@ Accepts lightweight heartbeat pings plus optional host/runtime payloads.
55
55
  "agent": {
56
56
  "id": 42,
57
57
  "name": "codex-runtime-prod",
58
- "models": [
59
- {
60
- "model_id": "openai/gpt-5-codex",
61
- "provider": "openai"
58
+ "identity": {
59
+ "name": "Jarvis",
60
+ "creature": "robot",
61
+ "vibe": "calm"
62
+ },
63
+ "models": {
64
+ "resolved": {
65
+ "default": "openai/gpt-5-codex",
66
+ "fallbacks": [
67
+ "anthropic/claude-sonnet-4-20250514"
68
+ ]
62
69
  },
63
- {
64
- "model_id": "anthropic/claude-sonnet-4-20250514",
65
- "provider": "anthropic"
70
+ "providers": {
71
+ "openai": [
72
+ "gpt-5-codex",
73
+ "gpt-4.1"
74
+ ],
75
+ "anthropic": [
76
+ "claude-sonnet-4-20250514"
77
+ ]
66
78
  }
67
- ]
79
+ }
68
80
  }
69
81
  }
70
82
  ```
@@ -234,16 +246,28 @@ const result = await client.operations.agentHeartbeat({
234
246
  "agent": {
235
247
  "id": 42,
236
248
  "name": "codex-runtime-prod",
237
- "models": [
238
- {
239
- "model_id": "openai/gpt-5-codex",
240
- "provider": "openai"
249
+ "identity": {
250
+ "name": "Jarvis",
251
+ "creature": "robot",
252
+ "vibe": "calm"
253
+ },
254
+ "models": {
255
+ "resolved": {
256
+ "default": "openai/gpt-5-codex",
257
+ "fallbacks": [
258
+ "anthropic/claude-sonnet-4-20250514"
259
+ ]
241
260
  },
242
- {
243
- "model_id": "anthropic/claude-sonnet-4-20250514",
244
- "provider": "anthropic"
261
+ "providers": {
262
+ "openai": [
263
+ "gpt-5-codex",
264
+ "gpt-4.1"
265
+ ],
266
+ "anthropic": [
267
+ "claude-sonnet-4-20250514"
268
+ ]
245
269
  }
246
- ]
270
+ }
247
271
  }
248
272
  }
249
273
  });
@@ -262,5 +286,5 @@ curl -X POST "https://agentmc.ai/api/v1/agents/1/heartbeat" \\
262
286
  -H "Accept: application/json" \\
263
287
  -H "X-Api-Key: $AGENTMC_API_KEY" \\
264
288
  -H "Content-Type: application/json" \\
265
- --data-raw "{\"status\":\"online\",\"meta\":{\"uptime_seconds\":43200,\"queue_depth\":2},\"host\":{\"fingerprint\":\"a3f56f330f311a2159f8c101eaf1439a29f1d57f007375d56aa79f304bc4f112\",\"name\":\"worker-01\",\"meta\":{\"hostname\":\"worker-01\",\"ip\":\"10.0.2.15\",\"network\":{\"private_ip\":\"10.0.2.15\",\"public_ip\":\"34.222.10.10\"},\"os\":\"Ubuntu\",\"os_version\":\"24.04\",\"arch\":\"x86_64\",\"cpu\":\"Intel Xeon\",\"cpu_cores\":8,\"ram_gb\":32,\"disk\":{\"total_bytes\":536870912000,\"free_bytes\":322122547200},\"uptime_seconds\":86400,\"runtime\":{\"name\":\"codex\",\"version\":\"2026.02.1\"}}},\"agent\":{\"id\":42,\"name\":\"codex-runtime-prod\",\"models\":[{\"model_id\":\"openai/gpt-5-codex\",\"provider\":\"openai\"},{\"model_id\":\"anthropic/claude-sonnet-4-20250514\",\"provider\":\"anthropic\"}]}}"
289
+ --data-raw "{\"status\":\"online\",\"meta\":{\"uptime_seconds\":43200,\"queue_depth\":2},\"host\":{\"fingerprint\":\"a3f56f330f311a2159f8c101eaf1439a29f1d57f007375d56aa79f304bc4f112\",\"name\":\"worker-01\",\"meta\":{\"hostname\":\"worker-01\",\"ip\":\"10.0.2.15\",\"network\":{\"private_ip\":\"10.0.2.15\",\"public_ip\":\"34.222.10.10\"},\"os\":\"Ubuntu\",\"os_version\":\"24.04\",\"arch\":\"x86_64\",\"cpu\":\"Intel Xeon\",\"cpu_cores\":8,\"ram_gb\":32,\"disk\":{\"total_bytes\":536870912000,\"free_bytes\":322122547200},\"uptime_seconds\":86400,\"runtime\":{\"name\":\"codex\",\"version\":\"2026.02.1\"}}},\"agent\":{\"id\":42,\"name\":\"codex-runtime-prod\",\"identity\":{\"name\":\"Jarvis\",\"creature\":\"robot\",\"vibe\":\"calm\"},\"models\":{\"resolved\":{\"default\":\"openai/gpt-5-codex\",\"fallbacks\":[\"anthropic/claude-sonnet-4-20250514\"]},\"providers\":{\"openai\":[\"gpt-5-codex\",\"gpt-4.1\"],\"anthropic\":[\"claude-sonnet-4-20250514\"]}}}}"
266
290
  ```
@@ -1,8 +1,8 @@
1
- # agentConnectedInstructions
1
+ # agentInstructions
2
2
 
3
3
  - Method: `GET`
4
- - Path: `/agents/{agent}/instructions`
5
- - Summary: Return runtime instructions for a connected agent using bearer auth.
4
+ - Path: `/agents/{agent}/agent-instructions`
5
+ - Summary: Return agent instructions for a connected agent using bearer auth.
6
6
  - Auth: AgentBearerAuth
7
7
 
8
8
  ## Description
@@ -22,11 +22,12 @@ None.
22
22
  ## Success Responses
23
23
 
24
24
  ### 200 (application/json)
25
- Instructions returned.
25
+ Agent instructions returned.
26
26
 
27
27
  ```json
28
28
  {
29
- "instructions": "# AgentMC Agent Sync Skill",
29
+ "agent_instructions": "# Agent Instructions",
30
+ "agent_instructions_version": "32fe7fd14fca2d57c545f5f78f4a1c094f9ac1b3a1e8f6f9f8323b67a0ef9cc3",
30
31
  "docs": [],
31
32
  "schedules": [],
32
33
  "config": {}
@@ -103,7 +104,7 @@ const client = new AgentMCApi({
103
104
  agentToken: process.env.AGENTMC_AGENT_TOKEN
104
105
  });
105
106
 
106
- const result = await client.operations.agentConnectedInstructions({
107
+ const result = await client.operations.agentInstructions({
107
108
  "params": {
108
109
  "path": {
109
110
  "agent": 1
@@ -121,7 +122,7 @@ if (result.error) {
121
122
  ## cURL Example
122
123
 
123
124
  ```bash
124
- curl -X GET "https://agentmc.ai/api/v1/agents/1/instructions" \\
125
+ curl -X GET "https://agentmc.ai/api/v1/agents/1/agent-instructions" \\
125
126
  -H "Accept: application/json" \\
126
127
  -H "Authorization: Bearer $AGENTMC_AGENT_TOKEN"
127
128
  ```
@@ -18,7 +18,7 @@ None.
18
18
  ### application/json
19
19
  ```json
20
20
  {
21
- "name": "codex-runtime-prod",
21
+ "name": "openclaw-main",
22
22
  "host": "ip-10-0-3-42",
23
23
  "runtime_version": "2026.02.1",
24
24
  "capabilities": [
@@ -26,6 +26,21 @@ None.
26
26
  "calendar",
27
27
  "realtime"
28
28
  ],
29
+ "models": [
30
+ {
31
+ "model_id": "openai/gpt-5-codex",
32
+ "provider": "openai"
33
+ },
34
+ {
35
+ "model_id": "anthropic/claude-sonnet-4-20250514",
36
+ "provider": "anthropic"
37
+ }
38
+ ],
39
+ "identity": {
40
+ "name": "Jarvis",
41
+ "creature": "robot",
42
+ "vibe": "calm"
43
+ },
29
44
  "metadata": {
30
45
  "hostname": "worker-01",
31
46
  "ip": "10.0.2.15",
@@ -47,6 +62,9 @@ None.
47
62
  "runtime": {
48
63
  "name": "codex",
49
64
  "version": "2026.02.1"
65
+ },
66
+ "identity": {
67
+ "name": "Jarvis"
50
68
  }
51
69
  }
52
70
  }
@@ -61,8 +79,8 @@ Agent connected and bearer token issued.
61
79
  {
62
80
  "agent_id": 42,
63
81
  "agent_token": "mca_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
64
- "agent_instructions_endpoint": "https://agentmc.example.com/api/v1/agents/42/instructions",
65
- "agent_authenticated_instructions_endpoint": "https://agentmc.example.com/api/v1/agents/42/instructions",
82
+ "agent_instructions_endpoint": "https://agentmc.example.com/api/v1/agents/42/agent-instructions",
83
+ "agent_authenticated_instructions_endpoint": "https://agentmc.example.com/api/v1/agents/42/agent-instructions",
66
84
  "agent_instructions_version": "32fe7fd14fca2d57c545f5f78f4a1c094f9ac1b3a1e8f6f9f8323b67a0ef9cc3",
67
85
  "openapi_url": "https://agentmc.example.com/api/openapi.json",
68
86
  "workspace": {
@@ -147,7 +165,7 @@ const client = new AgentMCApi({
147
165
 
148
166
  const result = await client.operations.connectAgent({
149
167
  "body": {
150
- "name": "codex-runtime-prod",
168
+ "name": "openclaw-main",
151
169
  "host": "ip-10-0-3-42",
152
170
  "runtime_version": "2026.02.1",
153
171
  "capabilities": [
@@ -155,6 +173,21 @@ const result = await client.operations.connectAgent({
155
173
  "calendar",
156
174
  "realtime"
157
175
  ],
176
+ "models": [
177
+ {
178
+ "model_id": "openai/gpt-5-codex",
179
+ "provider": "openai"
180
+ },
181
+ {
182
+ "model_id": "anthropic/claude-sonnet-4-20250514",
183
+ "provider": "anthropic"
184
+ }
185
+ ],
186
+ "identity": {
187
+ "name": "Jarvis",
188
+ "creature": "robot",
189
+ "vibe": "calm"
190
+ },
158
191
  "metadata": {
159
192
  "hostname": "worker-01",
160
193
  "ip": "10.0.2.15",
@@ -176,6 +209,9 @@ const result = await client.operations.connectAgent({
176
209
  "runtime": {
177
210
  "name": "codex",
178
211
  "version": "2026.02.1"
212
+ },
213
+ "identity": {
214
+ "name": "Jarvis"
179
215
  }
180
216
  }
181
217
  }
@@ -195,5 +231,5 @@ curl -X POST "https://agentmc.ai/api/v1/agents/connect" \\
195
231
  -H "Accept: application/json" \\
196
232
  -H "X-Connect-Token: $AGENTMC_CONNECT_TOKEN" \\
197
233
  -H "Content-Type: application/json" \\
198
- --data-raw "{\"name\":\"codex-runtime-prod\",\"host\":\"ip-10-0-3-42\",\"runtime_version\":\"2026.02.1\",\"capabilities\":[\"tasks\",\"calendar\",\"realtime\"],\"metadata\":{\"hostname\":\"worker-01\",\"ip\":\"10.0.2.15\",\"network\":{\"private_ip\":\"10.0.2.15\",\"public_ip\":\"34.201.22.9\"},\"os\":\"Ubuntu\",\"os_version\":\"22.04\",\"arch\":\"x86_64\",\"cpu\":\"Intel Xeon\",\"cpu_cores\":8,\"ram_gb\":32,\"disk\":{\"total_bytes\":512110190592,\"free_bytes\":321102110720},\"uptime_seconds\":86400,\"runtime\":{\"name\":\"codex\",\"version\":\"2026.02.1\"}}}"
234
+ --data-raw "{\"name\":\"openclaw-main\",\"host\":\"ip-10-0-3-42\",\"runtime_version\":\"2026.02.1\",\"capabilities\":[\"tasks\",\"calendar\",\"realtime\"],\"models\":[{\"model_id\":\"openai/gpt-5-codex\",\"provider\":\"openai\"},{\"model_id\":\"anthropic/claude-sonnet-4-20250514\",\"provider\":\"anthropic\"}],\"identity\":{\"name\":\"Jarvis\",\"creature\":\"robot\",\"vibe\":\"calm\"},\"metadata\":{\"hostname\":\"worker-01\",\"ip\":\"10.0.2.15\",\"network\":{\"private_ip\":\"10.0.2.15\",\"public_ip\":\"34.201.22.9\"},\"os\":\"Ubuntu\",\"os_version\":\"22.04\",\"arch\":\"x86_64\",\"cpu\":\"Intel Xeon\",\"cpu_cores\":8,\"ram_gb\":32,\"disk\":{\"total_bytes\":512110190592,\"free_bytes\":321102110720},\"uptime_seconds\":86400,\"runtime\":{\"name\":\"codex\",\"version\":\"2026.02.1\"},\"identity\":{\"name\":\"Jarvis\"}}}"
199
235
  ```
@@ -70,16 +70,6 @@ Calendar item created.
70
70
  "created_at": "2026-02-22T17:21:00Z"
71
71
  }
72
72
  ],
73
- "links": [
74
- {
75
- "id": 42,
76
- "link_type": "example",
77
- "link_id": 42,
78
- "url": "https://agentmc.example.com/docs/incident-123",
79
- "title": "Example Title",
80
- "created_at": "2026-02-22T17:21:00Z"
81
- }
82
- ],
83
73
  "comments_count": 1,
84
74
  "created_at": "2026-02-22T17:21:00Z",
85
75
  "updated_at": "2026-02-22T17:21:00Z",
@@ -1,101 +1,4 @@
1
1
  [
2
- {
3
- "operationId": "agentConnectedInstructions",
4
- "method": "get",
5
- "path": "/agents/{agent}/instructions",
6
- "summary": "Return runtime instructions for a connected agent using bearer auth.",
7
- "description": "",
8
- "tags": [
9
- "Agents"
10
- ],
11
- "security": [
12
- [
13
- "AgentBearerAuth"
14
- ]
15
- ],
16
- "parameters": [
17
- {
18
- "name": "agent",
19
- "in": "path",
20
- "required": true,
21
- "description": "Agent identifier.",
22
- "example": 1
23
- }
24
- ],
25
- "requestBodyRequired": false,
26
- "requestExamples": [],
27
- "responses": [
28
- {
29
- "status": "200",
30
- "mediaType": "application/json",
31
- "description": "Instructions returned.",
32
- "hasContent": true,
33
- "example": {
34
- "instructions": "# AgentMC Agent Sync Skill",
35
- "docs": [],
36
- "schedules": [],
37
- "config": {}
38
- }
39
- },
40
- {
41
- "status": "401",
42
- "mediaType": "application/json",
43
- "description": "Missing or invalid credentials.",
44
- "hasContent": true,
45
- "example": {
46
- "error": {
47
- "code": "validation.failed",
48
- "message": "Validation failed.",
49
- "details": {
50
- "fields": {
51
- "title": [
52
- "The title field is required."
53
- ]
54
- }
55
- }
56
- }
57
- }
58
- },
59
- {
60
- "status": "403",
61
- "mediaType": "application/json",
62
- "description": "Forbidden.",
63
- "hasContent": true,
64
- "example": {
65
- "error": {
66
- "code": "validation.failed",
67
- "message": "Validation failed.",
68
- "details": {
69
- "fields": {
70
- "title": [
71
- "The title field is required."
72
- ]
73
- }
74
- }
75
- }
76
- }
77
- },
78
- {
79
- "status": "404",
80
- "mediaType": "application/json",
81
- "description": "Resource not found.",
82
- "hasContent": true,
83
- "example": {
84
- "error": {
85
- "code": "validation.failed",
86
- "message": "Validation failed.",
87
- "details": {
88
- "fields": {
89
- "title": [
90
- "The title field is required."
91
- ]
92
- }
93
- }
94
- }
95
- }
96
- }
97
- ]
98
- },
99
2
  {
100
3
  "operationId": "agentHeartbeat",
101
4
  "method": "post",
@@ -165,16 +68,28 @@
165
68
  "agent": {
166
69
  "id": 42,
167
70
  "name": "codex-runtime-prod",
168
- "models": [
169
- {
170
- "model_id": "openai/gpt-5-codex",
171
- "provider": "openai"
71
+ "identity": {
72
+ "name": "Jarvis",
73
+ "creature": "robot",
74
+ "vibe": "calm"
75
+ },
76
+ "models": {
77
+ "resolved": {
78
+ "default": "openai/gpt-5-codex",
79
+ "fallbacks": [
80
+ "anthropic/claude-sonnet-4-20250514"
81
+ ]
172
82
  },
173
- {
174
- "model_id": "anthropic/claude-sonnet-4-20250514",
175
- "provider": "anthropic"
83
+ "providers": {
84
+ "openai": [
85
+ "gpt-5-codex",
86
+ "gpt-4.1"
87
+ ],
88
+ "anthropic": [
89
+ "claude-sonnet-4-20250514"
90
+ ]
176
91
  }
177
- ]
92
+ }
178
93
  }
179
94
  }
180
95
  }
@@ -290,6 +205,104 @@
290
205
  }
291
206
  ]
292
207
  },
208
+ {
209
+ "operationId": "agentInstructions",
210
+ "method": "get",
211
+ "path": "/agents/{agent}/agent-instructions",
212
+ "summary": "Return agent instructions for a connected agent using bearer auth.",
213
+ "description": "",
214
+ "tags": [
215
+ "Agents"
216
+ ],
217
+ "security": [
218
+ [
219
+ "AgentBearerAuth"
220
+ ]
221
+ ],
222
+ "parameters": [
223
+ {
224
+ "name": "agent",
225
+ "in": "path",
226
+ "required": true,
227
+ "description": "Agent identifier.",
228
+ "example": 1
229
+ }
230
+ ],
231
+ "requestBodyRequired": false,
232
+ "requestExamples": [],
233
+ "responses": [
234
+ {
235
+ "status": "200",
236
+ "mediaType": "application/json",
237
+ "description": "Agent instructions returned.",
238
+ "hasContent": true,
239
+ "example": {
240
+ "agent_instructions": "# Agent Instructions",
241
+ "agent_instructions_version": "32fe7fd14fca2d57c545f5f78f4a1c094f9ac1b3a1e8f6f9f8323b67a0ef9cc3",
242
+ "docs": [],
243
+ "schedules": [],
244
+ "config": {}
245
+ }
246
+ },
247
+ {
248
+ "status": "401",
249
+ "mediaType": "application/json",
250
+ "description": "Missing or invalid credentials.",
251
+ "hasContent": true,
252
+ "example": {
253
+ "error": {
254
+ "code": "validation.failed",
255
+ "message": "Validation failed.",
256
+ "details": {
257
+ "fields": {
258
+ "title": [
259
+ "The title field is required."
260
+ ]
261
+ }
262
+ }
263
+ }
264
+ }
265
+ },
266
+ {
267
+ "status": "403",
268
+ "mediaType": "application/json",
269
+ "description": "Forbidden.",
270
+ "hasContent": true,
271
+ "example": {
272
+ "error": {
273
+ "code": "validation.failed",
274
+ "message": "Validation failed.",
275
+ "details": {
276
+ "fields": {
277
+ "title": [
278
+ "The title field is required."
279
+ ]
280
+ }
281
+ }
282
+ }
283
+ }
284
+ },
285
+ {
286
+ "status": "404",
287
+ "mediaType": "application/json",
288
+ "description": "Resource not found.",
289
+ "hasContent": true,
290
+ "example": {
291
+ "error": {
292
+ "code": "validation.failed",
293
+ "message": "Validation failed.",
294
+ "details": {
295
+ "fields": {
296
+ "title": [
297
+ "The title field is required."
298
+ ]
299
+ }
300
+ }
301
+ }
302
+ }
303
+ }
304
+ ]
305
+ },
293
306
  {
294
307
  "operationId": "authenticateAgentRealtimeSocket",
295
308
  "method": "post",
@@ -919,7 +932,7 @@
919
932
  {
920
933
  "mediaType": "application/json",
921
934
  "example": {
922
- "name": "codex-runtime-prod",
935
+ "name": "openclaw-main",
923
936
  "host": "ip-10-0-3-42",
924
937
  "runtime_version": "2026.02.1",
925
938
  "capabilities": [
@@ -927,6 +940,21 @@
927
940
  "calendar",
928
941
  "realtime"
929
942
  ],
943
+ "models": [
944
+ {
945
+ "model_id": "openai/gpt-5-codex",
946
+ "provider": "openai"
947
+ },
948
+ {
949
+ "model_id": "anthropic/claude-sonnet-4-20250514",
950
+ "provider": "anthropic"
951
+ }
952
+ ],
953
+ "identity": {
954
+ "name": "Jarvis",
955
+ "creature": "robot",
956
+ "vibe": "calm"
957
+ },
930
958
  "metadata": {
931
959
  "hostname": "worker-01",
932
960
  "ip": "10.0.2.15",
@@ -948,6 +976,9 @@
948
976
  "runtime": {
949
977
  "name": "codex",
950
978
  "version": "2026.02.1"
979
+ },
980
+ "identity": {
981
+ "name": "Jarvis"
951
982
  }
952
983
  }
953
984
  }
@@ -962,8 +993,8 @@
962
993
  "example": {
963
994
  "agent_id": 42,
964
995
  "agent_token": "mca_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
965
- "agent_instructions_endpoint": "https://agentmc.example.com/api/v1/agents/42/instructions",
966
- "agent_authenticated_instructions_endpoint": "https://agentmc.example.com/api/v1/agents/42/instructions",
996
+ "agent_instructions_endpoint": "https://agentmc.example.com/api/v1/agents/42/agent-instructions",
997
+ "agent_authenticated_instructions_endpoint": "https://agentmc.example.com/api/v1/agents/42/agent-instructions",
967
998
  "agent_instructions_version": "32fe7fd14fca2d57c545f5f78f4a1c094f9ac1b3a1e8f6f9f8323b67a0ef9cc3",
968
999
  "openapi_url": "https://agentmc.example.com/api/openapi.json",
969
1000
  "workspace": {
@@ -1739,16 +1770,6 @@
1739
1770
  "created_at": "2026-02-22T17:21:00Z"
1740
1771
  }
1741
1772
  ],
1742
- "links": [
1743
- {
1744
- "id": 42,
1745
- "link_type": "example",
1746
- "link_id": 42,
1747
- "url": "https://agentmc.example.com/docs/incident-123",
1748
- "title": "Example Title",
1749
- "created_at": "2026-02-22T17:21:00Z"
1750
- }
1751
- ],
1752
1773
  "comments_count": 1,
1753
1774
  "created_at": "2026-02-22T17:21:00Z",
1754
1775
  "updated_at": "2026-02-22T17:21:00Z",
@@ -3739,16 +3760,6 @@
3739
3760
  "created_at": "2026-02-22T17:21:00Z"
3740
3761
  }
3741
3762
  ],
3742
- "links": [
3743
- {
3744
- "id": 42,
3745
- "link_type": "example",
3746
- "link_id": 42,
3747
- "url": "https://agentmc.example.com/docs/incident-123",
3748
- "title": "Example Title",
3749
- "created_at": "2026-02-22T17:21:00Z"
3750
- }
3751
- ],
3752
3763
  "comments_count": 1,
3753
3764
  "created_at": "2026-02-22T17:21:00Z",
3754
3765
  "updated_at": "2026-02-22T17:21:00Z",
@@ -4080,7 +4091,7 @@
4080
4091
  "operationId": "listNotifications",
4081
4092
  "method": "get",
4082
4093
  "path": "/notifications",
4083
- "summary": "List workspace notifications (mentions and assignments) for the authenticated principal.",
4094
+ "summary": "List workspace notifications (mentions, assignments, and comment activity) for the authenticated principal.",
4084
4095
  "description": "",
4085
4096
  "tags": [
4086
4097
  "Notifications"
@@ -5063,16 +5074,6 @@
5063
5074
  "created_at": "2026-02-22T17:21:00Z"
5064
5075
  }
5065
5076
  ],
5066
- "links": [
5067
- {
5068
- "id": 42,
5069
- "link_type": "example",
5070
- "link_id": 42,
5071
- "url": "https://agentmc.example.com/docs/incident-123",
5072
- "title": "Example Title",
5073
- "created_at": "2026-02-22T17:21:00Z"
5074
- }
5075
- ],
5076
5077
  "comments_count": 1,
5077
5078
  "created_at": "2026-02-22T17:21:00Z",
5078
5079
  "updated_at": "2026-02-22T17:21:00Z",
@@ -5963,16 +5964,6 @@
5963
5964
  "created_at": "2026-02-22T17:21:00Z"
5964
5965
  }
5965
5966
  ],
5966
- "links": [
5967
- {
5968
- "id": 42,
5969
- "link_type": "example",
5970
- "link_id": 42,
5971
- "url": "https://agentmc.example.com/docs/incident-123",
5972
- "title": "Example Title",
5973
- "created_at": "2026-02-22T17:21:00Z"
5974
- }
5975
- ],
5976
5967
  "comments_count": 1,
5977
5968
  "created_at": "2026-02-22T17:21:00Z",
5978
5969
  "updated_at": "2026-02-22T17:21:00Z",
@@ -62,16 +62,6 @@ Calendar items returned.
62
62
  "created_at": "2026-02-22T17:21:00Z"
63
63
  }
64
64
  ],
65
- "links": [
66
- {
67
- "id": 42,
68
- "link_type": "example",
69
- "link_id": 42,
70
- "url": "https://agentmc.example.com/docs/incident-123",
71
- "title": "Example Title",
72
- "created_at": "2026-02-22T17:21:00Z"
73
- }
74
- ],
75
65
  "comments_count": 1,
76
66
  "created_at": "2026-02-22T17:21:00Z",
77
67
  "updated_at": "2026-02-22T17:21:00Z",
@@ -2,7 +2,7 @@
2
2
 
3
3
  - Method: `GET`
4
4
  - Path: `/notifications`
5
- - Summary: List workspace notifications (mentions and assignments) for the authenticated principal.
5
+ - Summary: List workspace notifications (mentions, assignments, and comment activity) for the authenticated principal.
6
6
  - Auth: ApiKeyAuth OR AgentBearerAuth OR BearerAuth
7
7
 
8
8
  ## Description
@@ -53,16 +53,6 @@ Calendar item returned.
53
53
  "created_at": "2026-02-22T17:21:00Z"
54
54
  }
55
55
  ],
56
- "links": [
57
- {
58
- "id": 42,
59
- "link_type": "example",
60
- "link_id": 42,
61
- "url": "https://agentmc.example.com/docs/incident-123",
62
- "title": "Example Title",
63
- "created_at": "2026-02-22T17:21:00Z"
64
- }
65
- ],
66
56
  "comments_count": 1,
67
57
  "created_at": "2026-02-22T17:21:00Z",
68
58
  "updated_at": "2026-02-22T17:21:00Z",