The whole hunk
from line 1, old and new numbered
/
lines
from line 1
1---
2title: Get Deployment Run
3url: https://platform.claude.com/docs/en/api/beta/deployment_runs/retrieve
4---
5
16# Get Deployment Run
27
38**GET** `/v1/deployment_runs/{deployment_run_id}`
from line 21
1621
1722 - `string`
1823
19 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
24 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
2025
2126 - `"message-batches-2024-09-24"`
2227
from line 69
6469
6570 - `"user-profiles-2026-08-18"`
6671
72 - `"user-profiles-2026-09-04"`
73
6774 - `"advisor-tool-2026-03-01"`
6875
6976 - `"managed-agents-2026-04-01"`
from line 113
106113
107114 - `"mid-conversation-system-clear-at-2026-08-21"`
108115
116- `"anthropic-workspace-id": optional string`
117
109118## Returns
110119
111120- `BetaManagedAgentsDeploymentRun object`
from line 121
112121
113122 A persistent, append-only record of a single deployment execution. Records session creation success or failure — no session lifecycle tracking.
114123
124 - `type: "deployment_run"`
125
115126 - `id: string`
116127
117128 Unique identifier for this run (`drun_...`).
from line 131
120131
121132 A resolved agent reference with a concrete version.
122133
123 - `id: string`
124
125134 - `type: "agent"`
126135
136 - `id: string`
137
127138 - `version: number`
128139
129140 format: int32
from line 157
146157
147158 The deployment's environment was archived.
148159
160 - `type: "environment_archived_error"`
161
149162 - `message: string`
150163
151164 Human-readable error description.
152165
153 - `type: "environment_archived_error"`
154
155166 - `BetaManagedAgentsAgentArchivedRunError object`
156167
157168 The deployment's agent was archived.
158169
170 - `type: "agent_archived_error"`
171
159172 - `message: string`
160173
161174 Human-readable error description.
162175
163 - `type: "agent_archived_error"`
164
165176 - `BetaManagedAgentsEnvironmentNotFoundRunError object`
166177
167178 The deployment's environment no longer exists.
168179
180 - `type: "environment_not_found_error"`
181
169182 - `message: string`
170183
171184 Human-readable error description.
172185
173 - `type: "environment_not_found_error"`
174
175186 - `BetaManagedAgentsVaultNotFoundRunError object`
176187
177188 A vault referenced by the deployment no longer exists.
178189
190 - `type: "vault_not_found_error"`
191
179192 - `message: string`
180193
181194 Human-readable error description.
182195
183 - `type: "vault_not_found_error"`
184
185196 - `BetaManagedAgentsVaultArchivedRunError object`
186197
187198 A vault referenced by the deployment is archived.
188199
200 - `type: "vault_archived_error"`
201
189202 - `message: string`
190203
191204 Human-readable error description.
192205
193 - `type: "vault_archived_error"`
194
195206 - `BetaManagedAgentsFileNotFoundRunError object`
196207
197208 A file resource referenced by the deployment no longer exists.
198209
210 - `type: "file_not_found_error"`
211
199212 - `message: string`
200213
201214 Human-readable error description.
202215
203 - `type: "file_not_found_error"`
204
205216 - `BetaManagedAgentsMemoryStoreArchivedRunError object`
206217
207218 A memory store referenced by the deployment is archived.
208219
220 - `type: "memory_store_archived_error"`
221
209222 - `message: string`
210223
211224 Human-readable error description.
212225
213 - `type: "memory_store_archived_error"`
214
215226 - `BetaManagedAgentsSkillNotFoundRunError object`
216227
217228 A skill referenced by the deployment's agent no longer exists.
218229
230 - `type: "skill_not_found_error"`
231
219232 - `message: string`
220233
221234 Human-readable error description.
222235
223 - `type: "skill_not_found_error"`
224
225236 - `BetaManagedAgentsSessionResourceNotFoundRunError object`
226237
227238 A referenced resource no longer exists and its kind was not reported.
228239
240 - `type: "session_resource_not_found_error"`
241
229242 - `message: string`
230243
231244 Human-readable error description.
232245
233 - `type: "session_resource_not_found_error"`
234
235246 - `BetaManagedAgentsWorkspaceArchivedRunError object`
236247
237248 The deployment's workspace was archived.
238249
250 - `type: "workspace_archived_error"`
251
239252 - `message: string`
240253
241254 Human-readable error description.
242255
243 - `type: "workspace_archived_error"`
244
245256 - `BetaManagedAgentsOrganizationDisabledRunError object`
246257
247258 The deployment's organization is disabled.
248259
260 - `type: "organization_disabled_error"`
261
249262 - `message: string`
250263
251264 Human-readable error description.
252265
253 - `type: "organization_disabled_error"`
254
255266 - `BetaManagedAgentsSessionRateLimitedRunError object`
256267
257268 Session creation was rejected due to rate limiting. The schedule keeps firing; subsequent runs may succeed.
258269
270 - `type: "session_rate_limited_error"`
271
259272 - `message: string`
260273
261274 Human-readable error description.
262275
263 - `type: "session_rate_limited_error"`
264
265276 - `BetaManagedAgentsSessionCreationRejectedRunError object`
266277
267278 The session create request was rejected with a non-retryable validation error.
268279
280 - `type: "session_creation_rejected_error"`
281
269282 - `message: string`
270283
271284 Human-readable error description.
272285
273 - `type: "session_creation_rejected_error"`
274
275286 - `BetaManagedAgentsUnknownRunError object`
276287
277288 An unknown or unexpected error caused the run to fail. A fallback variant; clients that do not recognize a new error type can match on message alone.
278289
290 - `type: "unknown_error"`
291
279292 - `message: string`
280293
281294 Human-readable error description.
282295
283 - `type: "unknown_error"`
284
285296 - `BetaManagedAgentsSelfHostedResourcesUnsupportedRunError object`
286297
287298 The deployment configures resources, but its environment is self-hosted and cannot mount them.
288299
300 - `type: "self_hosted_resources_unsupported_error"`
301
289302 - `message: string`
290303
291304 Human-readable error description.
292305
293 - `type: "self_hosted_resources_unsupported_error"`
294
295306 - `BetaManagedAgentsMCPEgressBlockedRunError object`
296307
297308 An MCP server host used by the deployment's agent is blocked by the environment's network policy.
298309
310 - `type: "mcp_egress_blocked_error"`
311
299312 - `message: string`
300313
301314 Human-readable error description.
302315
303 - `type: "mcp_egress_blocked_error"`
304
305316 - `session_id: string or null`
306317
307318 Populated on success. Null on creation failure. Exactly one of `session_id` or `error` is non-null.
from line 325
314325
315326 The run was fired by the deployment's cron schedule.
316327
328 - `type: "schedule"`
329
317330 - `scheduled_at: string`
318331
319332 A timestamp in RFC 3339 format
from line 333
320333
321334 format: date-time
322335
323 - `type: "schedule"`
324
325336 - `BetaManagedAgentsManualTriggerContext object`
326337
327338 The run was started manually by creating a session directly against the deployment.
328339
329340 - `type: "manual"`
330
331 - `type: "deployment_run"`
332341
333342## Example
334343