@labelbox/rl-sdk 0.0.147 → 0.0.148

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.
@@ -7126,7 +7126,7 @@ export type LockProblemVersionDto = {
7126
7126
  };
7127
7127
  };
7128
7128
  /**
7129
- * A configured agent: its model, system prompt, tool and MCP surface, and the vault defaults new sessions inherit. Mutating an agent mints a new immutable AgentVersion; a session records the version it ran.
7129
+ * A configured agent: its versioned execution definition plus current mutable classification tags. Patching the execution definition mints a new immutable AgentVersion; applying tags does not. A session records the version it ran and never snapshots tags.
7130
7130
  */
7131
7131
  export type ManagedAgentsAgent = {
7132
7132
  /**
@@ -7206,6 +7206,10 @@ export type ManagedAgentsAgent = {
7206
7206
  * System prompt prepended to every conversation this agent runs.
7207
7207
  */
7208
7208
  system?: string;
7209
+ /**
7210
+ * Current organization-scoped classification tags applied to this agent. Always an array. Tags are mutable catalog metadata and are deliberately absent from AgentVersion and session runtime snapshots.
7211
+ */
7212
+ tags: Array<ManagedAgentsTag>;
7209
7213
  /**
7210
7214
  * Additional tool groups to enable, snapshotted into the session and passed to the execution runtime unchanged. This does NOT gate the sandbox tools: run_command, run_process, read_file and write_file are offered to every session with a sandbox whether or not this list mentions them, so a shell needs no entry here. The names a session actually offers the model are reported as config.available_builtin_tools on the started session -- read that rather than inferring the tool surface from this list.
7211
7215
  */
@@ -8247,6 +8251,23 @@ export type ManagedAgentsCreateEnvironmentRequest = {
8247
8251
  */
8248
8252
  stopped_delete_after_seconds?: number;
8249
8253
  };
8254
+ /**
8255
+ * Request body for creating one organization-scoped tag definition. The organization always comes from the authenticated principal.
8256
+ */
8257
+ export type ManagedAgentsCreateTagRequest = {
8258
+ /**
8259
+ * Display color in #RRGGBB form.
8260
+ */
8261
+ color: string;
8262
+ /**
8263
+ * Optional operator-facing explanation of this classification, up to 280 characters.
8264
+ */
8265
+ description?: string;
8266
+ /**
8267
+ * Display label. Leading and trailing whitespace is removed; the result must contain 1-32 characters and be unique case-insensitively among live tags in the organization.
8268
+ */
8269
+ label: string;
8270
+ };
8250
8271
  /**
8251
8272
  * Request body creating a Slack wake rule: the connection and event to match, and the agent, environment, and vaults a match runs with. Every referenced object must belong to the calling organization; GitHub events use provider-neutral automations instead.
8252
8273
  */
@@ -8376,7 +8397,7 @@ export type ManagedAgentsDefineOutcomeRequest = {
8376
8397
  rubric: string;
8377
8398
  };
8378
8399
  /**
8379
- * Shared response body of every soft-delete endpoint, on agents, environments, environment worker keys, vaults, vault credentials, webhook bindings, and sessions. Soft delete is a tombstone, not an erase: the row stops appearing in list and get responses but is retained, and there is no undelete endpoint to bring it back. Irreversible erasure is the separate, confirmation-gated purge path.
8400
+ * Shared response body of every soft-delete endpoint, on agents, environments, environment worker keys, tags, vaults, vault credentials, webhook bindings, and sessions. Soft delete is a tombstone, not an erase: the row stops appearing in list and get responses but is retained, and there is no undelete endpoint to bring it back. Irreversible erasure is the separate, confirmation-gated purge path.
8380
8401
  */
8381
8402
  export type ManagedAgentsDeletedResponse = {
8382
8403
  /**
@@ -10312,6 +10333,15 @@ export type ManagedAgentsReflectionListResponse = {
10312
10333
  */
10313
10334
  reflections?: unknown;
10314
10335
  };
10336
+ /**
10337
+ * Request body for atomically replacing an agent's complete mutable tag classification.
10338
+ */
10339
+ export type ManagedAgentsReplaceAgentTagsRequest = {
10340
+ /**
10341
+ * Complete replacement set of tag ids, with at most 32 distinct ids. Every id must be a live tag in the caller's organization. Duplicates are collapsed before enforcing the limit; [] removes every tag.
10342
+ */
10343
+ tag_ids: Array<string>;
10344
+ };
10315
10345
  /**
10316
10346
  * Structured input for manually starting an automation without a webhook delivery.
10317
10347
  */
@@ -11049,6 +11079,48 @@ export type ManagedAgentsStartSessionRequest = {
11049
11079
  */
11050
11080
  vault_ids?: Array<string>;
11051
11081
  };
11082
+ /**
11083
+ * An organization-scoped classification definition. Applying or removing it changes only catalog membership: it does not update the agent, mint an AgentVersion, or affect running sessions.
11084
+ */
11085
+ export type ManagedAgentsTag = {
11086
+ /**
11087
+ * Display color in #RRGGBB form.
11088
+ */
11089
+ color?: string;
11090
+ /**
11091
+ * Server-assigned RFC 3339 timestamp of when the tag was created.
11092
+ */
11093
+ created_at?: string;
11094
+ /**
11095
+ * Optional operator-facing explanation of the classification, up to 280 characters.
11096
+ */
11097
+ description?: string;
11098
+ /**
11099
+ * Display label, trimmed by the service. Unique case-insensitively among live tags in this organization.
11100
+ */
11101
+ label?: string;
11102
+ /**
11103
+ * Labelbox organization that owns the tag. Server-assigned from the authenticated principal and never accepted as authority from the request body.
11104
+ */
11105
+ organization_id?: string;
11106
+ /**
11107
+ * Server-assigned tag id (UUID).
11108
+ */
11109
+ tag_id?: string;
11110
+ /**
11111
+ * Server-assigned RFC 3339 timestamp of the most recent definition update.
11112
+ */
11113
+ updated_at?: string;
11114
+ };
11115
+ /**
11116
+ * A complete set of organization-scoped tag definitions. GET /v1/tags returns the organization catalog; agent tag PUT routes return the agent's resulting exact set.
11117
+ */
11118
+ export type ManagedAgentsTagListResponse = {
11119
+ /**
11120
+ * The complete live tag set for this response. Always an array; an empty array means no definitions exist or the agent has no classifications.
11121
+ */
11122
+ tags: Array<ManagedAgentsTag>;
11123
+ };
11052
11124
  /**
11053
11125
  * One tool or toolset enabled on an agent version, with its type-specific settings. Callers supply these when creating an agent version; the resulting session offers exactly the tools they declare.
11054
11126
  */
@@ -11209,6 +11281,117 @@ export type ManagedAgentsTriggerBindingListResponse = {
11209
11281
  */
11210
11282
  bindings?: unknown;
11211
11283
  };
11284
+ /**
11285
+ * Partial update to an agent's versioned execution definition. Omitted fields keep their current values. Tags are changed only through the dedicated agent tag routes.
11286
+ */
11287
+ export type ManagedAgentsUpdateAgentRequest = {
11288
+ /**
11289
+ * Server-assigned id of the agent, used in the agent, agent-version, and session routes.
11290
+ */
11291
+ agent_id?: string;
11292
+ /**
11293
+ * Server-assigned RFC 3339 timestamp of when the agent was created.
11294
+ */
11295
+ created_at?: string;
11296
+ /**
11297
+ * Caller-defined tools exposed to the model in addition to the built-in toolsets.
11298
+ */
11299
+ custom_tools?: unknown;
11300
+ /**
11301
+ * Narrows the default vaults to individual credentials. Every credential is selected when a vault is first added, and may then be unchecked.
11302
+ */
11303
+ default_credential_refs?: unknown;
11304
+ /**
11305
+ * Markdown rubric that sessions started from this agent are graded against when their create request omits an outcome. A session that supplies its own outcome ignores this entirely. Omit the field to keep the stored rubric; send an empty string to remove it.
11306
+ */
11307
+ default_rubric?: unknown;
11308
+ /**
11309
+ * Vaults whose credentials are copied into a new session when its create request omits vault_ids. Sending an explicit empty list on the session still overrides these.
11310
+ */
11311
+ default_vault_ids?: unknown;
11312
+ /**
11313
+ * Free-text note about what this agent is for.
11314
+ */
11315
+ description?: string;
11316
+ /**
11317
+ * Server-maintained id of the newest version of this agent; sessions started without an explicit version use it.
11318
+ */
11319
+ latest_agent_version_id?: string;
11320
+ /**
11321
+ * Remote MCP servers to attach. Each entry is an object with name (the label the server's tools are grouped under) and url (its http/https endpoint); any further keys are passed to the runtime unchanged. Credentials come from the vaults granted to the session, not from this entry. Tools are discovered and snapshotted at session start.
11322
+ */
11323
+ mcp_servers?: unknown;
11324
+ /**
11325
+ * Caller-owned key/value data stored with the agent and returned unchanged.
11326
+ */
11327
+ metadata?: {
11328
+ [key: string]: unknown;
11329
+ };
11330
+ /**
11331
+ * Model the agent runs on. Pass a gateway model id exactly as the gateway models catalog reports it, e.g. anthropic/claude-sonnet-4-5; it is stored prefixed as litellm:anthropic/claude-sonnet-4-5, which is the form the router reads and the form returned on reads. An explicitly provider-qualified string such as anthropic:claude-sonnet-4-5 selects a directly-configured provider instead and is left as written. An id the gateway does not serve is rejected here, not at the session's first turn.
11332
+ */
11333
+ model?: string;
11334
+ model_config?: ManagedAgentsInferenceConfig;
11335
+ /**
11336
+ * Canonical model-reference id to run instead of a gateway model id, for fine-tuned or self-hosted models.
11337
+ */
11338
+ model_ref_id?: string;
11339
+ /**
11340
+ * Multi-agent orchestration settings, such as subagent definitions and delegation limits.
11341
+ */
11342
+ multiagent?: {
11343
+ [key: string]: unknown;
11344
+ };
11345
+ /**
11346
+ * Human-readable label shown wherever agents are listed. Not required to be unique.
11347
+ */
11348
+ name?: string;
11349
+ /**
11350
+ * Labelbox organization that owns the agent. Server-assigned from the caller's credentials; a value sent in a request body is ignored.
11351
+ */
11352
+ organization_id?: string;
11353
+ /**
11354
+ * Runtime adapter configurations that change how the harness executes turns; each entry is adapter-specific.
11355
+ */
11356
+ runtime_adapters?: unknown;
11357
+ /**
11358
+ * Skill packages loaded into the agent's runtime, each an entry with the skill reference and its metadata.
11359
+ */
11360
+ skills?: unknown;
11361
+ /**
11362
+ * System prompt prepended to every conversation this agent runs.
11363
+ */
11364
+ system?: string;
11365
+ /**
11366
+ * Additional tool groups to enable, snapshotted into the session and passed to the execution runtime unchanged. This does NOT gate the sandbox tools: run_command, run_process, read_file and write_file are offered to every session with a sandbox whether or not this list mentions them, so a shell needs no entry here. The names a session actually offers the model are reported as config.available_builtin_tools on the started session -- read that rather than inferring the tool surface from this list.
11367
+ */
11368
+ toolsets?: unknown;
11369
+ /**
11370
+ * Server-assigned RFC 3339 timestamp of the most recent update to the agent.
11371
+ */
11372
+ updated_at?: string;
11373
+ /**
11374
+ * Whether new sessions may use the native web_search tool. Omitted on legacy agents and interpreted as enabled.
11375
+ */
11376
+ web_search_enabled?: boolean;
11377
+ };
11378
+ /**
11379
+ * Request body for changing a tag definition. Every field is optional and tag applications remain unchanged.
11380
+ */
11381
+ export type ManagedAgentsUpdateTagRequest = {
11382
+ /**
11383
+ * Replacement display color in #RRGGBB form. Omit to keep the current color.
11384
+ */
11385
+ color?: string;
11386
+ /**
11387
+ * Replacement description. Send an empty string to clear it; omit to keep the current description.
11388
+ */
11389
+ description?: string;
11390
+ /**
11391
+ * Replacement display label. Leading and trailing whitespace is removed. Omit to keep the current label.
11392
+ */
11393
+ label?: string;
11394
+ };
11212
11395
  /**
11213
11396
  * Partial update of one trigger binding. Only the properties present in the request change; an omitted property keeps its stored value, so an explicit false or empty list is distinguishable from an omission. The merged binding is revalidated as a whole, which is what keeps a single-field edit from bypassing a provider or tenancy invariant.
11214
11397
  */
@@ -22756,7 +22939,12 @@ export type WorkspaceFileDownloadUrlResponseDto = {
22756
22939
  export type GetManagedAgentsV1AgentsData = {
22757
22940
  body?: never;
22758
22941
  path?: never;
22759
- query?: never;
22942
+ query?: {
22943
+ /**
22944
+ * Comma-separated tag ids, with at most 32 distinct ids. Blank segments are ignored. An agent must carry every requested tag (AND semantics). Unknown or cross-organization ids return 404.
22945
+ */
22946
+ tag_ids?: string;
22947
+ };
22760
22948
  url: '/managed-agents/v1/agents';
22761
22949
  };
22762
22950
  export type GetManagedAgentsV1AgentsErrors = {
@@ -22772,6 +22960,10 @@ export type GetManagedAgentsV1AgentsErrors = {
22772
22960
  * Caller is missing a required permission, or the request scope (organization / environment / problem) does not resolve to the caller.
22773
22961
  */
22774
22962
  403: ApiErrorResponse;
22963
+ /**
22964
+ * No such resource is reachable for this caller. Carries the managed-agents envelope (`error.code` is the stable, machine-readable contract) when the request reached the service, or the platform envelope when this API rejected it before forwarding.
22965
+ */
22966
+ 404: ManagedAgentsApiErrorBody | ApiErrorResponse;
22775
22967
  /**
22776
22968
  * A rate limit is exhausted. Honor `Retry-After`. Carries the managed-agents envelope (`error.code` is the stable, machine-readable contract) when the request reached the service, or the platform envelope when this API rejected it before forwarding.
22777
22969
  */
@@ -22836,7 +23028,7 @@ export type PostManagedAgentsV1AgentsErrors = {
22836
23028
  export type PostManagedAgentsV1AgentsError = PostManagedAgentsV1AgentsErrors[keyof PostManagedAgentsV1AgentsErrors];
22837
23029
  export type PostManagedAgentsV1AgentsResponses = {
22838
23030
  /**
22839
- * A configured agent: its model, system prompt, tool and MCP surface, and the vault defaults new sessions inherit. Mutating an agent mints a new immutable AgentVersion; a session records the version it ran.
23031
+ * A configured agent: its versioned execution definition plus current mutable classification tags. Patching the execution definition mints a new immutable AgentVersion; applying tags does not. A session records the version it ran and never snapshots tags.
22840
23032
  */
22841
23033
  200: ManagedAgentsAgent;
22842
23034
  };
@@ -22889,7 +23081,7 @@ export type DeleteManagedAgentsV1AgentsByAgentIdErrors = {
22889
23081
  export type DeleteManagedAgentsV1AgentsByAgentIdError = DeleteManagedAgentsV1AgentsByAgentIdErrors[keyof DeleteManagedAgentsV1AgentsByAgentIdErrors];
22890
23082
  export type DeleteManagedAgentsV1AgentsByAgentIdResponses = {
22891
23083
  /**
22892
- * Shared response body of every soft-delete endpoint, on agents, environments, environment worker keys, vaults, vault credentials, webhook bindings, and sessions. Soft delete is a tombstone, not an erase: the row stops appearing in list and get responses but is retained, and there is no undelete endpoint to bring it back. Irreversible erasure is the separate, confirmation-gated purge path.
23084
+ * Shared response body of every soft-delete endpoint, on agents, environments, environment worker keys, tags, vaults, vault credentials, webhook bindings, and sessions. Soft delete is a tombstone, not an erase: the row stops appearing in list and get responses but is retained, and there is no undelete endpoint to bring it back. Irreversible erasure is the separate, confirmation-gated purge path.
22893
23085
  */
22894
23086
  200: ManagedAgentsDeletedResponse;
22895
23087
  };
@@ -22938,13 +23130,13 @@ export type GetManagedAgentsV1AgentsByAgentIdErrors = {
22938
23130
  export type GetManagedAgentsV1AgentsByAgentIdError = GetManagedAgentsV1AgentsByAgentIdErrors[keyof GetManagedAgentsV1AgentsByAgentIdErrors];
22939
23131
  export type GetManagedAgentsV1AgentsByAgentIdResponses = {
22940
23132
  /**
22941
- * A configured agent: its model, system prompt, tool and MCP surface, and the vault defaults new sessions inherit. Mutating an agent mints a new immutable AgentVersion; a session records the version it ran.
23133
+ * A configured agent: its versioned execution definition plus current mutable classification tags. Patching the execution definition mints a new immutable AgentVersion; applying tags does not. A session records the version it ran and never snapshots tags.
22942
23134
  */
22943
23135
  200: ManagedAgentsAgent;
22944
23136
  };
22945
23137
  export type GetManagedAgentsV1AgentsByAgentIdResponse = GetManagedAgentsV1AgentsByAgentIdResponses[keyof GetManagedAgentsV1AgentsByAgentIdResponses];
22946
23138
  export type PatchManagedAgentsV1AgentsByAgentIdData = {
22947
- body?: ManagedAgentsAgent;
23139
+ body?: ManagedAgentsUpdateAgentRequest;
22948
23140
  path: {
22949
23141
  /**
22950
23142
  * Agent id (UUID) as returned by createAgent or listAgents.
@@ -22995,7 +23187,7 @@ export type PatchManagedAgentsV1AgentsByAgentIdErrors = {
22995
23187
  export type PatchManagedAgentsV1AgentsByAgentIdError = PatchManagedAgentsV1AgentsByAgentIdErrors[keyof PatchManagedAgentsV1AgentsByAgentIdErrors];
22996
23188
  export type PatchManagedAgentsV1AgentsByAgentIdResponses = {
22997
23189
  /**
22998
- * A configured agent: its model, system prompt, tool and MCP surface, and the vault defaults new sessions inherit. Mutating an agent mints a new immutable AgentVersion; a session records the version it ran.
23190
+ * A configured agent: its versioned execution definition plus current mutable classification tags. Patching the execution definition mints a new immutable AgentVersion; applying tags does not. A session records the version it ran and never snapshots tags.
22999
23191
  */
23000
23192
  200: ManagedAgentsAgent;
23001
23193
  };
@@ -23167,6 +23359,177 @@ export type PostManagedAgentsV1AgentsByAgentIdReflectionsResponses = {
23167
23359
  202: ManagedAgentsReflection;
23168
23360
  };
23169
23361
  export type PostManagedAgentsV1AgentsByAgentIdReflectionsResponse = PostManagedAgentsV1AgentsByAgentIdReflectionsResponses[keyof PostManagedAgentsV1AgentsByAgentIdReflectionsResponses];
23362
+ export type PutManagedAgentsV1AgentsByAgentIdTagsData = {
23363
+ body?: ManagedAgentsReplaceAgentTagsRequest;
23364
+ path: {
23365
+ /**
23366
+ * Agent id (UUID) whose classifications are replaced.
23367
+ */
23368
+ agent_id: string;
23369
+ };
23370
+ query?: never;
23371
+ url: '/managed-agents/v1/agents/{agent_id}/tags';
23372
+ };
23373
+ export type PutManagedAgentsV1AgentsByAgentIdTagsErrors = {
23374
+ /**
23375
+ * The request was rejected by schema or semantic validation. Carries the managed-agents envelope (`error.code` is the stable, machine-readable contract) when the request reached the service, or the platform envelope when this API rejected it before forwarding.
23376
+ */
23377
+ 400: ManagedAgentsApiErrorBody | ApiErrorResponse;
23378
+ /**
23379
+ * The caller is unauthenticated. Carries the managed-agents envelope (`error.code` is the stable, machine-readable contract) when the request reached the service, or the platform envelope when this API rejected it before forwarding.
23380
+ */
23381
+ 401: ManagedAgentsApiErrorBody | ApiErrorResponse;
23382
+ /**
23383
+ * Caller is missing a required permission, or the request scope (organization / environment / problem) does not resolve to the caller.
23384
+ */
23385
+ 403: ApiErrorResponse;
23386
+ /**
23387
+ * No such resource is reachable for this caller. Carries the managed-agents envelope (`error.code` is the stable, machine-readable contract) when the request reached the service, or the platform envelope when this API rejected it before forwarding.
23388
+ */
23389
+ 404: ManagedAgentsApiErrorBody | ApiErrorResponse;
23390
+ /**
23391
+ * The request conflicts with the resource state, or with an in-flight idempotent replay. Carries the managed-agents envelope (`error.code` is the stable, machine-readable contract) when the request reached the service, or the platform envelope when this API rejected it before forwarding.
23392
+ */
23393
+ 409: ManagedAgentsApiErrorBody | ApiErrorResponse;
23394
+ /**
23395
+ * The request exceeds a size or transaction budget. Carries the managed-agents envelope (`error.code` is the stable, machine-readable contract) when the request reached the service, or the platform envelope when this API rejected it before forwarding.
23396
+ */
23397
+ 413: ManagedAgentsApiErrorBody | ApiErrorResponse;
23398
+ /**
23399
+ * A rate limit is exhausted. Honor `Retry-After`. Carries the managed-agents envelope (`error.code` is the stable, machine-readable contract) when the request reached the service, or the platform envelope when this API rejected it before forwarding.
23400
+ */
23401
+ 429: ManagedAgentsApiErrorBody | ApiErrorResponse;
23402
+ /**
23403
+ * An unexpected server-side failure. Carries the managed-agents envelope (`error.code` is the stable, machine-readable contract) when the request reached the service, or the platform envelope when this API rejected it before forwarding.
23404
+ */
23405
+ 500: ManagedAgentsApiErrorBody | ApiErrorResponse;
23406
+ /**
23407
+ * A dependency is unavailable. Retryable. Carries the managed-agents envelope (`error.code` is the stable, machine-readable contract) when the request reached the service, or the platform envelope when this API rejected it before forwarding.
23408
+ */
23409
+ 503: ManagedAgentsApiErrorBody | ApiErrorResponse;
23410
+ };
23411
+ export type PutManagedAgentsV1AgentsByAgentIdTagsError = PutManagedAgentsV1AgentsByAgentIdTagsErrors[keyof PutManagedAgentsV1AgentsByAgentIdTagsErrors];
23412
+ export type PutManagedAgentsV1AgentsByAgentIdTagsResponses = {
23413
+ /**
23414
+ * A complete set of organization-scoped tag definitions. GET /v1/tags returns the organization catalog; agent tag PUT routes return the agent's resulting exact set.
23415
+ */
23416
+ 200: ManagedAgentsTagListResponse;
23417
+ };
23418
+ export type PutManagedAgentsV1AgentsByAgentIdTagsResponse = PutManagedAgentsV1AgentsByAgentIdTagsResponses[keyof PutManagedAgentsV1AgentsByAgentIdTagsResponses];
23419
+ export type DeleteManagedAgentsV1AgentsByAgentIdTagsByTagIdData = {
23420
+ body?: never;
23421
+ path: {
23422
+ /**
23423
+ * Agent id (UUID) as returned by createAgent or listAgents.
23424
+ */
23425
+ agent_id: string;
23426
+ /**
23427
+ * Tag id (UUID) as returned by createTag or listTags.
23428
+ */
23429
+ tag_id: string;
23430
+ };
23431
+ query?: never;
23432
+ url: '/managed-agents/v1/agents/{agent_id}/tags/{tag_id}';
23433
+ };
23434
+ export type DeleteManagedAgentsV1AgentsByAgentIdTagsByTagIdErrors = {
23435
+ /**
23436
+ * The request was rejected by schema or semantic validation. Carries the managed-agents envelope (`error.code` is the stable, machine-readable contract) when the request reached the service, or the platform envelope when this API rejected it before forwarding.
23437
+ */
23438
+ 400: ManagedAgentsApiErrorBody | ApiErrorResponse;
23439
+ /**
23440
+ * The caller is unauthenticated. Carries the managed-agents envelope (`error.code` is the stable, machine-readable contract) when the request reached the service, or the platform envelope when this API rejected it before forwarding.
23441
+ */
23442
+ 401: ManagedAgentsApiErrorBody | ApiErrorResponse;
23443
+ /**
23444
+ * Caller is missing a required permission, or the request scope (organization / environment / problem) does not resolve to the caller.
23445
+ */
23446
+ 403: ApiErrorResponse;
23447
+ /**
23448
+ * No such resource is reachable for this caller. Carries the managed-agents envelope (`error.code` is the stable, machine-readable contract) when the request reached the service, or the platform envelope when this API rejected it before forwarding.
23449
+ */
23450
+ 404: ManagedAgentsApiErrorBody | ApiErrorResponse;
23451
+ /**
23452
+ * The request conflicts with the resource state, or with an in-flight idempotent replay. Carries the managed-agents envelope (`error.code` is the stable, machine-readable contract) when the request reached the service, or the platform envelope when this API rejected it before forwarding.
23453
+ */
23454
+ 409: ManagedAgentsApiErrorBody | ApiErrorResponse;
23455
+ /**
23456
+ * A rate limit is exhausted. Honor `Retry-After`. Carries the managed-agents envelope (`error.code` is the stable, machine-readable contract) when the request reached the service, or the platform envelope when this API rejected it before forwarding.
23457
+ */
23458
+ 429: ManagedAgentsApiErrorBody | ApiErrorResponse;
23459
+ /**
23460
+ * An unexpected server-side failure. Carries the managed-agents envelope (`error.code` is the stable, machine-readable contract) when the request reached the service, or the platform envelope when this API rejected it before forwarding.
23461
+ */
23462
+ 500: ManagedAgentsApiErrorBody | ApiErrorResponse;
23463
+ /**
23464
+ * A dependency is unavailable. Retryable. Carries the managed-agents envelope (`error.code` is the stable, machine-readable contract) when the request reached the service, or the platform envelope when this API rejected it before forwarding.
23465
+ */
23466
+ 503: ManagedAgentsApiErrorBody | ApiErrorResponse;
23467
+ };
23468
+ export type DeleteManagedAgentsV1AgentsByAgentIdTagsByTagIdError = DeleteManagedAgentsV1AgentsByAgentIdTagsByTagIdErrors[keyof DeleteManagedAgentsV1AgentsByAgentIdTagsByTagIdErrors];
23469
+ export type DeleteManagedAgentsV1AgentsByAgentIdTagsByTagIdResponses = {
23470
+ /**
23471
+ * No Content
23472
+ */
23473
+ 204: void;
23474
+ };
23475
+ export type DeleteManagedAgentsV1AgentsByAgentIdTagsByTagIdResponse = DeleteManagedAgentsV1AgentsByAgentIdTagsByTagIdResponses[keyof DeleteManagedAgentsV1AgentsByAgentIdTagsByTagIdResponses];
23476
+ export type PutManagedAgentsV1AgentsByAgentIdTagsByTagIdData = {
23477
+ body?: never;
23478
+ path: {
23479
+ /**
23480
+ * Agent id (UUID) as returned by createAgent or listAgents.
23481
+ */
23482
+ agent_id: string;
23483
+ /**
23484
+ * Tag id (UUID) as returned by createTag or listTags.
23485
+ */
23486
+ tag_id: string;
23487
+ };
23488
+ query?: never;
23489
+ url: '/managed-agents/v1/agents/{agent_id}/tags/{tag_id}';
23490
+ };
23491
+ export type PutManagedAgentsV1AgentsByAgentIdTagsByTagIdErrors = {
23492
+ /**
23493
+ * The request was rejected by schema or semantic validation. Carries the managed-agents envelope (`error.code` is the stable, machine-readable contract) when the request reached the service, or the platform envelope when this API rejected it before forwarding.
23494
+ */
23495
+ 400: ManagedAgentsApiErrorBody | ApiErrorResponse;
23496
+ /**
23497
+ * The caller is unauthenticated. Carries the managed-agents envelope (`error.code` is the stable, machine-readable contract) when the request reached the service, or the platform envelope when this API rejected it before forwarding.
23498
+ */
23499
+ 401: ManagedAgentsApiErrorBody | ApiErrorResponse;
23500
+ /**
23501
+ * Caller is missing a required permission, or the request scope (organization / environment / problem) does not resolve to the caller.
23502
+ */
23503
+ 403: ApiErrorResponse;
23504
+ /**
23505
+ * No such resource is reachable for this caller. Carries the managed-agents envelope (`error.code` is the stable, machine-readable contract) when the request reached the service, or the platform envelope when this API rejected it before forwarding.
23506
+ */
23507
+ 404: ManagedAgentsApiErrorBody | ApiErrorResponse;
23508
+ /**
23509
+ * The request conflicts with the resource state, or with an in-flight idempotent replay. Carries the managed-agents envelope (`error.code` is the stable, machine-readable contract) when the request reached the service, or the platform envelope when this API rejected it before forwarding.
23510
+ */
23511
+ 409: ManagedAgentsApiErrorBody | ApiErrorResponse;
23512
+ /**
23513
+ * A rate limit is exhausted. Honor `Retry-After`. Carries the managed-agents envelope (`error.code` is the stable, machine-readable contract) when the request reached the service, or the platform envelope when this API rejected it before forwarding.
23514
+ */
23515
+ 429: ManagedAgentsApiErrorBody | ApiErrorResponse;
23516
+ /**
23517
+ * An unexpected server-side failure. Carries the managed-agents envelope (`error.code` is the stable, machine-readable contract) when the request reached the service, or the platform envelope when this API rejected it before forwarding.
23518
+ */
23519
+ 500: ManagedAgentsApiErrorBody | ApiErrorResponse;
23520
+ /**
23521
+ * A dependency is unavailable. Retryable. Carries the managed-agents envelope (`error.code` is the stable, machine-readable contract) when the request reached the service, or the platform envelope when this API rejected it before forwarding.
23522
+ */
23523
+ 503: ManagedAgentsApiErrorBody | ApiErrorResponse;
23524
+ };
23525
+ export type PutManagedAgentsV1AgentsByAgentIdTagsByTagIdError = PutManagedAgentsV1AgentsByAgentIdTagsByTagIdErrors[keyof PutManagedAgentsV1AgentsByAgentIdTagsByTagIdErrors];
23526
+ export type PutManagedAgentsV1AgentsByAgentIdTagsByTagIdResponses = {
23527
+ /**
23528
+ * A complete set of organization-scoped tag definitions. GET /v1/tags returns the organization catalog; agent tag PUT routes return the agent's resulting exact set.
23529
+ */
23530
+ 200: ManagedAgentsTagListResponse;
23531
+ };
23532
+ export type PutManagedAgentsV1AgentsByAgentIdTagsByTagIdResponse = PutManagedAgentsV1AgentsByAgentIdTagsByTagIdResponses[keyof PutManagedAgentsV1AgentsByAgentIdTagsByTagIdResponses];
23170
23533
  export type GetManagedAgentsV1AgentsByAgentIdVersionsData = {
23171
23534
  body?: never;
23172
23535
  path: {
@@ -23835,7 +24198,7 @@ export type DeleteManagedAgentsV1EnvironmentsByEnvironmentIdErrors = {
23835
24198
  export type DeleteManagedAgentsV1EnvironmentsByEnvironmentIdError = DeleteManagedAgentsV1EnvironmentsByEnvironmentIdErrors[keyof DeleteManagedAgentsV1EnvironmentsByEnvironmentIdErrors];
23836
24199
  export type DeleteManagedAgentsV1EnvironmentsByEnvironmentIdResponses = {
23837
24200
  /**
23838
- * Shared response body of every soft-delete endpoint, on agents, environments, environment worker keys, vaults, vault credentials, webhook bindings, and sessions. Soft delete is a tombstone, not an erase: the row stops appearing in list and get responses but is retained, and there is no undelete endpoint to bring it back. Irreversible erasure is the separate, confirmation-gated purge path.
24201
+ * Shared response body of every soft-delete endpoint, on agents, environments, environment worker keys, tags, vaults, vault credentials, webhook bindings, and sessions. Soft delete is a tombstone, not an erase: the row stops appearing in list and get responses but is retained, and there is no undelete endpoint to bring it back. Irreversible erasure is the separate, confirmation-gated purge path.
23839
24202
  */
23840
24203
  200: ManagedAgentsDeletedResponse;
23841
24204
  };
@@ -25402,6 +25765,10 @@ export type GetManagedAgentsV1SessionsData = {
25402
25765
  * Filter by agent id.
25403
25766
  */
25404
25767
  agent_id?: string;
25768
+ /**
25769
+ * Comma-separated current agent tag ids, with at most 32 distinct ids. A session row's agent must carry every requested tag (AND semantics). Unknown or cross-organization ids return 404. Tags are resolved at read time, not from the session snapshot.
25770
+ */
25771
+ tag_ids?: string;
25405
25772
  external_source_type?: string;
25406
25773
  external_source_id?: string;
25407
25774
  /**
@@ -25425,6 +25792,10 @@ export type GetManagedAgentsV1SessionsErrors = {
25425
25792
  * Caller is missing a required permission, or the request scope (organization / environment / problem) does not resolve to the caller.
25426
25793
  */
25427
25794
  403: ApiErrorResponse;
25795
+ /**
25796
+ * No such resource is reachable for this caller. Carries the managed-agents envelope (`error.code` is the stable, machine-readable contract) when the request reached the service, or the platform envelope when this API rejected it before forwarding.
25797
+ */
25798
+ 404: ManagedAgentsApiErrorBody | ApiErrorResponse;
25428
25799
  /**
25429
25800
  * A rate limit is exhausted. Honor `Retry-After`. Carries the managed-agents envelope (`error.code` is the stable, machine-readable contract) when the request reached the service, or the platform envelope when this API rejected it before forwarding.
25430
25801
  */
@@ -25642,7 +26013,7 @@ export type DeleteManagedAgentsV1SessionsBySessionIdErrors = {
25642
26013
  export type DeleteManagedAgentsV1SessionsBySessionIdError = DeleteManagedAgentsV1SessionsBySessionIdErrors[keyof DeleteManagedAgentsV1SessionsBySessionIdErrors];
25643
26014
  export type DeleteManagedAgentsV1SessionsBySessionIdResponses = {
25644
26015
  /**
25645
- * Shared response body of every soft-delete endpoint, on agents, environments, environment worker keys, vaults, vault credentials, webhook bindings, and sessions. Soft delete is a tombstone, not an erase: the row stops appearing in list and get responses but is retained, and there is no undelete endpoint to bring it back. Irreversible erasure is the separate, confirmation-gated purge path.
26016
+ * Shared response body of every soft-delete endpoint, on agents, environments, environment worker keys, tags, vaults, vault credentials, webhook bindings, and sessions. Soft delete is a tombstone, not an erase: the row stops appearing in list and get responses but is retained, and there is no undelete endpoint to bring it back. Irreversible erasure is the separate, confirmation-gated purge path.
25646
26017
  */
25647
26018
  200: ManagedAgentsDeletedResponse;
25648
26019
  };
@@ -26507,7 +26878,7 @@ export type DeleteManagedAgentsV1SkillsBySkillIdErrors = {
26507
26878
  export type DeleteManagedAgentsV1SkillsBySkillIdError = DeleteManagedAgentsV1SkillsBySkillIdErrors[keyof DeleteManagedAgentsV1SkillsBySkillIdErrors];
26508
26879
  export type DeleteManagedAgentsV1SkillsBySkillIdResponses = {
26509
26880
  /**
26510
- * Shared response body of every soft-delete endpoint, on agents, environments, environment worker keys, vaults, vault credentials, webhook bindings, and sessions. Soft delete is a tombstone, not an erase: the row stops appearing in list and get responses but is retained, and there is no undelete endpoint to bring it back. Irreversible erasure is the separate, confirmation-gated purge path.
26881
+ * Shared response body of every soft-delete endpoint, on agents, environments, environment worker keys, tags, vaults, vault credentials, webhook bindings, and sessions. Soft delete is a tombstone, not an erase: the row stops appearing in list and get responses but is retained, and there is no undelete endpoint to bring it back. Irreversible erasure is the separate, confirmation-gated purge path.
26511
26882
  */
26512
26883
  200: ManagedAgentsDeletedResponse;
26513
26884
  };
@@ -26720,6 +27091,253 @@ export type GetManagedAgentsV1SkillsBySkillIdVersionsBySkillVersionIdResponses =
26720
27091
  200: ManagedAgentsSkillVersion;
26721
27092
  };
26722
27093
  export type GetManagedAgentsV1SkillsBySkillIdVersionsBySkillVersionIdResponse = GetManagedAgentsV1SkillsBySkillIdVersionsBySkillVersionIdResponses[keyof GetManagedAgentsV1SkillsBySkillIdVersionsBySkillVersionIdResponses];
27094
+ export type GetManagedAgentsV1TagsData = {
27095
+ body?: never;
27096
+ path?: never;
27097
+ query?: never;
27098
+ url: '/managed-agents/v1/tags';
27099
+ };
27100
+ export type GetManagedAgentsV1TagsErrors = {
27101
+ /**
27102
+ * The request was rejected by schema or semantic validation. Carries the managed-agents envelope (`error.code` is the stable, machine-readable contract) when the request reached the service, or the platform envelope when this API rejected it before forwarding.
27103
+ */
27104
+ 400: ManagedAgentsApiErrorBody | ApiErrorResponse;
27105
+ /**
27106
+ * The caller is unauthenticated. Carries the managed-agents envelope (`error.code` is the stable, machine-readable contract) when the request reached the service, or the platform envelope when this API rejected it before forwarding.
27107
+ */
27108
+ 401: ManagedAgentsApiErrorBody | ApiErrorResponse;
27109
+ /**
27110
+ * Caller is missing a required permission, or the request scope (organization / environment / problem) does not resolve to the caller.
27111
+ */
27112
+ 403: ApiErrorResponse;
27113
+ /**
27114
+ * A rate limit is exhausted. Honor `Retry-After`. Carries the managed-agents envelope (`error.code` is the stable, machine-readable contract) when the request reached the service, or the platform envelope when this API rejected it before forwarding.
27115
+ */
27116
+ 429: ManagedAgentsApiErrorBody | ApiErrorResponse;
27117
+ /**
27118
+ * An unexpected server-side failure. Carries the managed-agents envelope (`error.code` is the stable, machine-readable contract) when the request reached the service, or the platform envelope when this API rejected it before forwarding.
27119
+ */
27120
+ 500: ManagedAgentsApiErrorBody | ApiErrorResponse;
27121
+ /**
27122
+ * A dependency is unavailable. Retryable. Carries the managed-agents envelope (`error.code` is the stable, machine-readable contract) when the request reached the service, or the platform envelope when this API rejected it before forwarding.
27123
+ */
27124
+ 503: ManagedAgentsApiErrorBody | ApiErrorResponse;
27125
+ };
27126
+ export type GetManagedAgentsV1TagsError = GetManagedAgentsV1TagsErrors[keyof GetManagedAgentsV1TagsErrors];
27127
+ export type GetManagedAgentsV1TagsResponses = {
27128
+ /**
27129
+ * A complete set of organization-scoped tag definitions. GET /v1/tags returns the organization catalog; agent tag PUT routes return the agent's resulting exact set.
27130
+ */
27131
+ 200: ManagedAgentsTagListResponse;
27132
+ };
27133
+ export type GetManagedAgentsV1TagsResponse = GetManagedAgentsV1TagsResponses[keyof GetManagedAgentsV1TagsResponses];
27134
+ export type PostManagedAgentsV1TagsData = {
27135
+ body?: ManagedAgentsCreateTagRequest;
27136
+ path?: never;
27137
+ query?: never;
27138
+ url: '/managed-agents/v1/tags';
27139
+ };
27140
+ export type PostManagedAgentsV1TagsErrors = {
27141
+ /**
27142
+ * The request was rejected by schema or semantic validation. Carries the managed-agents envelope (`error.code` is the stable, machine-readable contract) when the request reached the service, or the platform envelope when this API rejected it before forwarding.
27143
+ */
27144
+ 400: ManagedAgentsApiErrorBody | ApiErrorResponse;
27145
+ /**
27146
+ * The caller is unauthenticated. Carries the managed-agents envelope (`error.code` is the stable, machine-readable contract) when the request reached the service, or the platform envelope when this API rejected it before forwarding.
27147
+ */
27148
+ 401: ManagedAgentsApiErrorBody | ApiErrorResponse;
27149
+ /**
27150
+ * Caller is missing a required permission, or the request scope (organization / environment / problem) does not resolve to the caller.
27151
+ */
27152
+ 403: ApiErrorResponse;
27153
+ /**
27154
+ * The request conflicts with the resource state, or with an in-flight idempotent replay. Carries the managed-agents envelope (`error.code` is the stable, machine-readable contract) when the request reached the service, or the platform envelope when this API rejected it before forwarding.
27155
+ */
27156
+ 409: ManagedAgentsApiErrorBody | ApiErrorResponse;
27157
+ /**
27158
+ * The request exceeds a size or transaction budget. Carries the managed-agents envelope (`error.code` is the stable, machine-readable contract) when the request reached the service, or the platform envelope when this API rejected it before forwarding.
27159
+ */
27160
+ 413: ManagedAgentsApiErrorBody | ApiErrorResponse;
27161
+ /**
27162
+ * A rate limit is exhausted. Honor `Retry-After`. Carries the managed-agents envelope (`error.code` is the stable, machine-readable contract) when the request reached the service, or the platform envelope when this API rejected it before forwarding.
27163
+ */
27164
+ 429: ManagedAgentsApiErrorBody | ApiErrorResponse;
27165
+ /**
27166
+ * An unexpected server-side failure. Carries the managed-agents envelope (`error.code` is the stable, machine-readable contract) when the request reached the service, or the platform envelope when this API rejected it before forwarding.
27167
+ */
27168
+ 500: ManagedAgentsApiErrorBody | ApiErrorResponse;
27169
+ /**
27170
+ * A dependency is unavailable. Retryable. Carries the managed-agents envelope (`error.code` is the stable, machine-readable contract) when the request reached the service, or the platform envelope when this API rejected it before forwarding.
27171
+ */
27172
+ 503: ManagedAgentsApiErrorBody | ApiErrorResponse;
27173
+ };
27174
+ export type PostManagedAgentsV1TagsError = PostManagedAgentsV1TagsErrors[keyof PostManagedAgentsV1TagsErrors];
27175
+ export type PostManagedAgentsV1TagsResponses = {
27176
+ /**
27177
+ * An organization-scoped classification definition. Applying or removing it changes only catalog membership: it does not update the agent, mint an AgentVersion, or affect running sessions.
27178
+ */
27179
+ 200: ManagedAgentsTag;
27180
+ };
27181
+ export type PostManagedAgentsV1TagsResponse = PostManagedAgentsV1TagsResponses[keyof PostManagedAgentsV1TagsResponses];
27182
+ export type DeleteManagedAgentsV1TagsByTagIdData = {
27183
+ body?: never;
27184
+ path: {
27185
+ /**
27186
+ * Tag id (UUID) as returned by createTag or listTags.
27187
+ */
27188
+ tag_id: string;
27189
+ };
27190
+ query?: never;
27191
+ url: '/managed-agents/v1/tags/{tag_id}';
27192
+ };
27193
+ export type DeleteManagedAgentsV1TagsByTagIdErrors = {
27194
+ /**
27195
+ * The request was rejected by schema or semantic validation. Carries the managed-agents envelope (`error.code` is the stable, machine-readable contract) when the request reached the service, or the platform envelope when this API rejected it before forwarding.
27196
+ */
27197
+ 400: ManagedAgentsApiErrorBody | ApiErrorResponse;
27198
+ /**
27199
+ * The caller is unauthenticated. Carries the managed-agents envelope (`error.code` is the stable, machine-readable contract) when the request reached the service, or the platform envelope when this API rejected it before forwarding.
27200
+ */
27201
+ 401: ManagedAgentsApiErrorBody | ApiErrorResponse;
27202
+ /**
27203
+ * Caller is missing a required permission, or the request scope (organization / environment / problem) does not resolve to the caller.
27204
+ */
27205
+ 403: ApiErrorResponse;
27206
+ /**
27207
+ * No such resource is reachable for this caller. Carries the managed-agents envelope (`error.code` is the stable, machine-readable contract) when the request reached the service, or the platform envelope when this API rejected it before forwarding.
27208
+ */
27209
+ 404: ManagedAgentsApiErrorBody | ApiErrorResponse;
27210
+ /**
27211
+ * The request conflicts with the resource state, or with an in-flight idempotent replay. Carries the managed-agents envelope (`error.code` is the stable, machine-readable contract) when the request reached the service, or the platform envelope when this API rejected it before forwarding.
27212
+ */
27213
+ 409: ManagedAgentsApiErrorBody | ApiErrorResponse;
27214
+ /**
27215
+ * A rate limit is exhausted. Honor `Retry-After`. Carries the managed-agents envelope (`error.code` is the stable, machine-readable contract) when the request reached the service, or the platform envelope when this API rejected it before forwarding.
27216
+ */
27217
+ 429: ManagedAgentsApiErrorBody | ApiErrorResponse;
27218
+ /**
27219
+ * An unexpected server-side failure. Carries the managed-agents envelope (`error.code` is the stable, machine-readable contract) when the request reached the service, or the platform envelope when this API rejected it before forwarding.
27220
+ */
27221
+ 500: ManagedAgentsApiErrorBody | ApiErrorResponse;
27222
+ /**
27223
+ * A dependency is unavailable. Retryable. Carries the managed-agents envelope (`error.code` is the stable, machine-readable contract) when the request reached the service, or the platform envelope when this API rejected it before forwarding.
27224
+ */
27225
+ 503: ManagedAgentsApiErrorBody | ApiErrorResponse;
27226
+ };
27227
+ export type DeleteManagedAgentsV1TagsByTagIdError = DeleteManagedAgentsV1TagsByTagIdErrors[keyof DeleteManagedAgentsV1TagsByTagIdErrors];
27228
+ export type DeleteManagedAgentsV1TagsByTagIdResponses = {
27229
+ /**
27230
+ * Shared response body of every soft-delete endpoint, on agents, environments, environment worker keys, tags, vaults, vault credentials, webhook bindings, and sessions. Soft delete is a tombstone, not an erase: the row stops appearing in list and get responses but is retained, and there is no undelete endpoint to bring it back. Irreversible erasure is the separate, confirmation-gated purge path.
27231
+ */
27232
+ 200: ManagedAgentsDeletedResponse;
27233
+ };
27234
+ export type DeleteManagedAgentsV1TagsByTagIdResponse = DeleteManagedAgentsV1TagsByTagIdResponses[keyof DeleteManagedAgentsV1TagsByTagIdResponses];
27235
+ export type GetManagedAgentsV1TagsByTagIdData = {
27236
+ body?: never;
27237
+ path: {
27238
+ /**
27239
+ * Tag id (UUID) as returned by createTag or listTags.
27240
+ */
27241
+ tag_id: string;
27242
+ };
27243
+ query?: never;
27244
+ url: '/managed-agents/v1/tags/{tag_id}';
27245
+ };
27246
+ export type GetManagedAgentsV1TagsByTagIdErrors = {
27247
+ /**
27248
+ * The request was rejected by schema or semantic validation. Carries the managed-agents envelope (`error.code` is the stable, machine-readable contract) when the request reached the service, or the platform envelope when this API rejected it before forwarding.
27249
+ */
27250
+ 400: ManagedAgentsApiErrorBody | ApiErrorResponse;
27251
+ /**
27252
+ * The caller is unauthenticated. Carries the managed-agents envelope (`error.code` is the stable, machine-readable contract) when the request reached the service, or the platform envelope when this API rejected it before forwarding.
27253
+ */
27254
+ 401: ManagedAgentsApiErrorBody | ApiErrorResponse;
27255
+ /**
27256
+ * Caller is missing a required permission, or the request scope (organization / environment / problem) does not resolve to the caller.
27257
+ */
27258
+ 403: ApiErrorResponse;
27259
+ /**
27260
+ * No such resource is reachable for this caller. Carries the managed-agents envelope (`error.code` is the stable, machine-readable contract) when the request reached the service, or the platform envelope when this API rejected it before forwarding.
27261
+ */
27262
+ 404: ManagedAgentsApiErrorBody | ApiErrorResponse;
27263
+ /**
27264
+ * A rate limit is exhausted. Honor `Retry-After`. Carries the managed-agents envelope (`error.code` is the stable, machine-readable contract) when the request reached the service, or the platform envelope when this API rejected it before forwarding.
27265
+ */
27266
+ 429: ManagedAgentsApiErrorBody | ApiErrorResponse;
27267
+ /**
27268
+ * An unexpected server-side failure. Carries the managed-agents envelope (`error.code` is the stable, machine-readable contract) when the request reached the service, or the platform envelope when this API rejected it before forwarding.
27269
+ */
27270
+ 500: ManagedAgentsApiErrorBody | ApiErrorResponse;
27271
+ /**
27272
+ * A dependency is unavailable. Retryable. Carries the managed-agents envelope (`error.code` is the stable, machine-readable contract) when the request reached the service, or the platform envelope when this API rejected it before forwarding.
27273
+ */
27274
+ 503: ManagedAgentsApiErrorBody | ApiErrorResponse;
27275
+ };
27276
+ export type GetManagedAgentsV1TagsByTagIdError = GetManagedAgentsV1TagsByTagIdErrors[keyof GetManagedAgentsV1TagsByTagIdErrors];
27277
+ export type GetManagedAgentsV1TagsByTagIdResponses = {
27278
+ /**
27279
+ * An organization-scoped classification definition. Applying or removing it changes only catalog membership: it does not update the agent, mint an AgentVersion, or affect running sessions.
27280
+ */
27281
+ 200: ManagedAgentsTag;
27282
+ };
27283
+ export type GetManagedAgentsV1TagsByTagIdResponse = GetManagedAgentsV1TagsByTagIdResponses[keyof GetManagedAgentsV1TagsByTagIdResponses];
27284
+ export type PatchManagedAgentsV1TagsByTagIdData = {
27285
+ body?: ManagedAgentsUpdateTagRequest;
27286
+ path: {
27287
+ /**
27288
+ * Tag id (UUID) as returned by createTag or listTags.
27289
+ */
27290
+ tag_id: string;
27291
+ };
27292
+ query?: never;
27293
+ url: '/managed-agents/v1/tags/{tag_id}';
27294
+ };
27295
+ export type PatchManagedAgentsV1TagsByTagIdErrors = {
27296
+ /**
27297
+ * The request was rejected by schema or semantic validation. Carries the managed-agents envelope (`error.code` is the stable, machine-readable contract) when the request reached the service, or the platform envelope when this API rejected it before forwarding.
27298
+ */
27299
+ 400: ManagedAgentsApiErrorBody | ApiErrorResponse;
27300
+ /**
27301
+ * The caller is unauthenticated. Carries the managed-agents envelope (`error.code` is the stable, machine-readable contract) when the request reached the service, or the platform envelope when this API rejected it before forwarding.
27302
+ */
27303
+ 401: ManagedAgentsApiErrorBody | ApiErrorResponse;
27304
+ /**
27305
+ * Caller is missing a required permission, or the request scope (organization / environment / problem) does not resolve to the caller.
27306
+ */
27307
+ 403: ApiErrorResponse;
27308
+ /**
27309
+ * No such resource is reachable for this caller. Carries the managed-agents envelope (`error.code` is the stable, machine-readable contract) when the request reached the service, or the platform envelope when this API rejected it before forwarding.
27310
+ */
27311
+ 404: ManagedAgentsApiErrorBody | ApiErrorResponse;
27312
+ /**
27313
+ * The request conflicts with the resource state, or with an in-flight idempotent replay. Carries the managed-agents envelope (`error.code` is the stable, machine-readable contract) when the request reached the service, or the platform envelope when this API rejected it before forwarding.
27314
+ */
27315
+ 409: ManagedAgentsApiErrorBody | ApiErrorResponse;
27316
+ /**
27317
+ * The request exceeds a size or transaction budget. Carries the managed-agents envelope (`error.code` is the stable, machine-readable contract) when the request reached the service, or the platform envelope when this API rejected it before forwarding.
27318
+ */
27319
+ 413: ManagedAgentsApiErrorBody | ApiErrorResponse;
27320
+ /**
27321
+ * A rate limit is exhausted. Honor `Retry-After`. Carries the managed-agents envelope (`error.code` is the stable, machine-readable contract) when the request reached the service, or the platform envelope when this API rejected it before forwarding.
27322
+ */
27323
+ 429: ManagedAgentsApiErrorBody | ApiErrorResponse;
27324
+ /**
27325
+ * An unexpected server-side failure. Carries the managed-agents envelope (`error.code` is the stable, machine-readable contract) when the request reached the service, or the platform envelope when this API rejected it before forwarding.
27326
+ */
27327
+ 500: ManagedAgentsApiErrorBody | ApiErrorResponse;
27328
+ /**
27329
+ * A dependency is unavailable. Retryable. Carries the managed-agents envelope (`error.code` is the stable, machine-readable contract) when the request reached the service, or the platform envelope when this API rejected it before forwarding.
27330
+ */
27331
+ 503: ManagedAgentsApiErrorBody | ApiErrorResponse;
27332
+ };
27333
+ export type PatchManagedAgentsV1TagsByTagIdError = PatchManagedAgentsV1TagsByTagIdErrors[keyof PatchManagedAgentsV1TagsByTagIdErrors];
27334
+ export type PatchManagedAgentsV1TagsByTagIdResponses = {
27335
+ /**
27336
+ * An organization-scoped classification definition. Applying or removing it changes only catalog membership: it does not update the agent, mint an AgentVersion, or affect running sessions.
27337
+ */
27338
+ 200: ManagedAgentsTag;
27339
+ };
27340
+ export type PatchManagedAgentsV1TagsByTagIdResponse = PatchManagedAgentsV1TagsByTagIdResponses[keyof PatchManagedAgentsV1TagsByTagIdResponses];
26723
27341
  export type GetManagedAgentsV1TriggerBindingsData = {
26724
27342
  body?: never;
26725
27343
  path?: never;
@@ -26861,7 +27479,7 @@ export type DeleteManagedAgentsV1TriggerBindingsByBindingIdErrors = {
26861
27479
  export type DeleteManagedAgentsV1TriggerBindingsByBindingIdError = DeleteManagedAgentsV1TriggerBindingsByBindingIdErrors[keyof DeleteManagedAgentsV1TriggerBindingsByBindingIdErrors];
26862
27480
  export type DeleteManagedAgentsV1TriggerBindingsByBindingIdResponses = {
26863
27481
  /**
26864
- * Shared response body of every soft-delete endpoint, on agents, environments, environment worker keys, vaults, vault credentials, webhook bindings, and sessions. Soft delete is a tombstone, not an erase: the row stops appearing in list and get responses but is retained, and there is no undelete endpoint to bring it back. Irreversible erasure is the separate, confirmation-gated purge path.
27482
+ * Shared response body of every soft-delete endpoint, on agents, environments, environment worker keys, tags, vaults, vault credentials, webhook bindings, and sessions. Soft delete is a tombstone, not an erase: the row stops appearing in list and get responses but is retained, and there is no undelete endpoint to bring it back. Irreversible erasure is the separate, confirmation-gated purge path.
26865
27483
  */
26866
27484
  200: ManagedAgentsDeletedResponse;
26867
27485
  };
@@ -27059,7 +27677,7 @@ export type DeleteManagedAgentsV1VaultsByVaultIdErrors = {
27059
27677
  export type DeleteManagedAgentsV1VaultsByVaultIdError = DeleteManagedAgentsV1VaultsByVaultIdErrors[keyof DeleteManagedAgentsV1VaultsByVaultIdErrors];
27060
27678
  export type DeleteManagedAgentsV1VaultsByVaultIdResponses = {
27061
27679
  /**
27062
- * Shared response body of every soft-delete endpoint, on agents, environments, environment worker keys, vaults, vault credentials, webhook bindings, and sessions. Soft delete is a tombstone, not an erase: the row stops appearing in list and get responses but is retained, and there is no undelete endpoint to bring it back. Irreversible erasure is the separate, confirmation-gated purge path.
27680
+ * Shared response body of every soft-delete endpoint, on agents, environments, environment worker keys, tags, vaults, vault credentials, webhook bindings, and sessions. Soft delete is a tombstone, not an erase: the row stops appearing in list and get responses but is retained, and there is no undelete endpoint to bring it back. Irreversible erasure is the separate, confirmation-gated purge path.
27063
27681
  */
27064
27682
  200: ManagedAgentsDeletedResponse;
27065
27683
  };
@@ -27328,7 +27946,7 @@ export type DeleteManagedAgentsV1VaultsByVaultIdCredentialsByCredentialIdErrors
27328
27946
  export type DeleteManagedAgentsV1VaultsByVaultIdCredentialsByCredentialIdError = DeleteManagedAgentsV1VaultsByVaultIdCredentialsByCredentialIdErrors[keyof DeleteManagedAgentsV1VaultsByVaultIdCredentialsByCredentialIdErrors];
27329
27947
  export type DeleteManagedAgentsV1VaultsByVaultIdCredentialsByCredentialIdResponses = {
27330
27948
  /**
27331
- * Shared response body of every soft-delete endpoint, on agents, environments, environment worker keys, vaults, vault credentials, webhook bindings, and sessions. Soft delete is a tombstone, not an erase: the row stops appearing in list and get responses but is retained, and there is no undelete endpoint to bring it back. Irreversible erasure is the separate, confirmation-gated purge path.
27949
+ * Shared response body of every soft-delete endpoint, on agents, environments, environment worker keys, tags, vaults, vault credentials, webhook bindings, and sessions. Soft delete is a tombstone, not an erase: the row stops appearing in list and get responses but is retained, and there is no undelete endpoint to bring it back. Irreversible erasure is the separate, confirmation-gated purge path.
27332
27950
  */
27333
27951
  200: ManagedAgentsDeletedResponse;
27334
27952
  };